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
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mist-orgs-devices-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
contact:
email: tmunzer@juniper.net
name: Thomas Munzer
description: '> Version: **2606.1.1**
>
> Date: **July 10, 2026**
<div class="notification"> NOTE:<br>Some important API changes will be introduced. Please make sure to read the <a href="https://www.juniper.net/documentation/us/en/software/mist/api/http/guides/important-api-changes">announcements</a> </div>
---
## Additional Documentation
* [Mist Automation Guide](https://www.juniper.net/documentation/us/en/software/mist/automation-integration/index.html)
* [Mist Location SDK](https://www.juniper.net/documentation/us/en/software/mist/location-services/topics/concept/mist-how-get-mist-sdk.html)
* [Mist Product Updates](https://www.juniper.net/documentation/us/en/software/mist/product-updates/)
## Helpful Resources
* [API Sandbox and Exercises](https://api-class.mist.com/)
* [Postman Collection, Runners and Webhook Samples](https://www.postman.com/juniper-mist/workspace/mist-systems-s-public-workspace)
* [Python Script Examples](https://github.com/tmunzer/mist_library)
* [API Demo Apps](https://apps.mist-lab.fr/)
* [Juniper Blog](https://blogs.juniper.net/)
## Mist Web Browser Extension:
* Google Chrome, Microsoft Edge and other Chromium-based browser: [Chrome Web Store](https://chromewebstore.google.com/detail/mist-extension/ejhpdcljeamillfhdihkkmoakanpbplh)
* Firefox: [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/mist-extension/)
---'
license:
name: MIT
url: https://raw.githubusercontent.com/tmunzer/Mist-OAS3.0/main/LICENSE
title: Mist Orgs Devices API
version: 2606.1.1
x-logo:
altText: Juniper-MistAI
backgroundColor: '#FFFFFF'
url: https://www.mist.com/wp-content/uploads/logo.png
servers:
- description: Mist Global 01
url: https://api.mist.com
- description: Mist Global 02
url: https://api.gc1.mist.com
- description: Mist Global 03
url: https://api.ac2.mist.com
- description: Mist Global 04
url: https://api.gc2.mist.com
- description: Mist Global 05
url: https://api.gc4.mist.com
- description: Mist EMEA 01
url: https://api.eu.mist.com
- description: Mist EMEA 02
url: https://api.gc3.mist.com
- description: Mist EMEA 03
url: https://api.ac6.mist.com
- description: Mist EMEA 04
url: https://api.gc6.mist.com
- description: Mist APAC 01
url: https://api.ac5.mist.com
- description: Mist APAC 02
url: https://api.gc5.mist.com
- description: Mist APAC 03
url: https://api.gc7.mist.com
security:
- apiToken: []
- csrfToken: []
tags:
- 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
paths:
/api/v1/orgs/{org_id}/devices:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: List devices in the organization, including APs, switches and gateways managed or monitored by Mist.
operationId: listOrgDevices
responses:
'200':
$ref: '#/components/responses/OrgDevices'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listOrgDevices
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/count:
parameters:
- $ref: '#/components/parameters/org_id'
get:
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:
- 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`'
in: query
name: distinct
schema:
$ref: '#/components/schemas/org_devices_count_distinct'
- description: Partial / full hostname
in: query
name: hostname
schema:
examples:
- my-hostname
type: string
- description: Filter results by site identifier
in: query
name: site_id
schema:
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
format: uuid
type: string
- description: Filter results by device model. Accepts multiple comma-separated values.
in: query
name: model
schema:
examples:
- AP45,AP47D
- MR84
type: string
- deprecated: true
description: 'for switches and gateways, to filter on managed/unmanaged devices. Deprecated in favour of mist_configured. enum: `true`, `false`'
in: query
name: managed
schema:
examples:
- 'true'
type: string
- description: Filter results by MAC address
in: query
name: mac
schema:
examples:
- 5c5b53010101
type: string
- description: Filter results by software version
in: query
name: version
schema:
examples:
- 10.0.0
type: string
- $ref: '#/components/parameters/ip'
- description: 'MxTunnel status, enum: `up`, `down`'
in: query
name: mxtunnel_status
schema:
$ref: '#/components/schemas/count_org_devices_mxtunnel_status'
- description: Mist Edge id, if AP is connecting to a Mist Edge
in: query
name: mxedge_id
schema:
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
format: uuid
type: string
- description: Filter results by LLDP system name
in: query
name: lldp_system_name
schema:
examples:
- my-lldp-system
type: string
- description: Filter results by LLDP system description
in: query
name: lldp_system_desc
schema:
examples:
- my-lldp-system-description
type: string
- description: Filter results by LLDP port identifier
in: query
name: lldp_port_id
schema:
examples:
- ge-0/0/1
type: string
- description: LLDP management IP address
in: query
name: lldp_mgmt_addr
schema:
examples:
- 10.4.2.3
type: string
- description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
in: query
name: type
schema:
$ref: '#/components/schemas/device_type_default_ap'
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/duration'
- $ref: '#/components/parameters/limit'
responses:
'200':
$ref: '#/components/responses/Count'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: countOrgDevices
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/events/count:
parameters:
- $ref: '#/components/parameters/org_id'
get:
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:
- description: 'Field used to group this count response. enum: `ap`, `apfw`, `model`, `org_id`, `site_id`, `text`, `timestamp`, `type`'
in: query
name: distinct
schema:
$ref: '#/components/schemas/org_devices_events_count_distinct'
- description: Filter results by site identifier
in: query
name: site_id
schema:
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
format: uuid
type: string
- description: Filter results by AP MAC address
in: query
name: ap
schema:
examples:
- 5c5b53010101
type: string
- description: Filter results by AP firmware version
in: query
name: apfw
schema:
examples:
- 10.0.0
type: string
- description: Filter results by device model
in: query
name: model
schema:
examples:
- AP43
type: string
- description: Filter results by event message text
in: query
name: text
schema:
examples:
- Device connected
type: string
- $ref: '#/components/parameters/device_event_type'
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/duration'
- $ref: '#/components/parameters/limit'
responses:
'200':
$ref: '#/components/responses/Count'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: countOrgDeviceEvents
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/events/search:
parameters:
- $ref: '#/components/parameters/org_id'
get:
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:
- description: Filter results by MAC address. Accepts multiple comma-separated values.
in: query
name: mac
schema:
examples:
- 5c5b53010101,5c5b53020202
- 5c5b53010101
type: string
- description: Filter results by device model. Accepts multiple comma-separated values.
in: query
name: model
schema:
examples:
- EX4100-48MP,AP17
- AP43
type: string
- description: Filter results by device type. Accepts multiple comma-separated values.
example: switch,ap
in: query
name: device_type
schema:
$ref: '#/components/schemas/device_type_with_all'
- description: Filter results by event message text
in: query
name: text
schema:
examples:
- Device connected
type: string
- description: See [List Device Events Definitions](/#operations/listDeviceEventsDefinitions). Accepts multiple comma-separated values.
in: query
name: type
schema:
examples:
- SW_PORT_DOWN,AP_CONFIGURED
type: string
- description: Return last/recent event for passed in field
in: query
name: last_by
schema:
examples:
- port_id
type: string
- description: Keyword to include events from additional indices (e.g. ext_tunnel for prisma events)
in: query
name: includes
schema:
examples:
- ext_tunnel
type: string
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/duration'
- $ref: '#/components/parameters/sort'
- $ref: '#/components/parameters/search_after'
responses:
'200':
$ref: '#/components/responses/DeviceEventsSearch'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: searchOrgDeviceEvents
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/last_config/count:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: Count device config history records across the organization, optionally grouped by `distinct` and filtered by device type and time range.
operationId: countOrgDeviceLastConfigs
parameters:
- description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
in: query
name: type
schema:
$ref: '#/components/schemas/device_type_default_ap'
- description: 'Field used to group this count response. enum: `mac`, `name`, `site_id`, `version`'
in: query
name: distinct
schema:
$ref: '#/components/schemas/org_devices_last_configs_count_distinct'
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/duration'
- $ref: '#/components/parameters/limit'
responses:
'200':
$ref: '#/components/responses/Count'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: countOrgDeviceLastConfigs
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/last_config/search:
parameters:
- $ref: '#/components/parameters/org_id'
get:
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:
- description: 'Filter results by device type. enum: `ap`, `gateway`, `switch`, `mxedge`'
in: query
name: device_type
schema:
$ref: '#/components/schemas/last_config_device_type'
- description: Filter results by MAC address. Accepts multiple comma-separated values.
in: query
name: mac
schema:
examples:
- 5c5b53010101,5c5b53020202
- 5c5b53010101
type: string
- description: Filter results by name. Accepts multiple comma-separated values.
in: query
name: name
schema:
examples:
- name-a,name-b
- My AP
type: string
- description: Filter results by software version. Accepts multiple comma-separated values.
in: query
name: version
schema:
examples:
- apfw-0.15.34615-noro-0a3c,apfw-0.15.34436-noro-d810
- 10.0.0
type: string
- description: 'Duration for expiring cert queries (format: 2d/3h/172800 seconds)'
in: query
name: cert_expiry_duration
schema:
examples:
- 2d
type: string
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/duration'
- $ref: '#/components/parameters/sort'
- $ref: '#/components/parameters/search_after'
responses:
'200':
$ref: '#/components/responses/ConfigsHistorySearch'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: searchOrgDeviceLastConfigs
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/radio_macs:
parameters:
- $ref: '#/components/parameters/org_id'
get:
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:
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/page'
responses:
'200':
$ref: '#/components/responses/RadioMacs'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listOrgApsMacs
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/search:
parameters:
- $ref: '#/components/parameters/org_id'
get:
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:
- description: When `type`==`ap`, Channel of band_24. Accepts multiple comma-separated integer values.
in: query
name: band_24_channel
schema:
examples:
- 1,64
type: integer
- description: When `type`==`ap`, Channel of band_5. Accepts multiple comma-separated integer values.
in: query
name: band_5_channel
schema:
examples:
- 153,108
type: integer
- description: When `type`==`ap`, Channel of band_6. Accepts multiple comma-separated integer values.
in: query
name: band_6_channel
schema:
examples:
- 197,221
type: integer
- description: When `type`==`ap`, Bandwidth of band_24. Accepts multiple comma-separated integer values.
in: query
name: band_24_bandwidth
schema:
examples:
- 0,20
type: integer
- description: When `type`==`ap`, Bandwidth of band_5. Accepts multiple comma-separated integer values.
in: query
name: band_5_bandwidth
schema:
examples:
- 20,40
type: integer
- description: When `type`==`ap`, Bandwidth of band_6. Accepts multiple comma-separated integer values.
in: query
name: band_6_bandwidth
schema:
examples:
- 80,40
type: integer
- description: When `type`==`ap`, Power of band_24. Accepts multiple comma-separated integer values.
in: query
name: band_24_power
schema:
examples:
- 0,17
type: integer
- description: When `type`==`ap`, Power of band_5. Accepts multiple comma-separated integer values.
in: query
name: band_5_power
schema:
examples:
- 17,11
type: integer
- description: When `type`==`ap`, Power of band_6. Accepts multiple comma-separated integer values.
in: query
name: band_6_power
schema:
examples:
- 14,12
type: integer
- description: When `type`==`gateway`, true / false
in: query
name: clustered
schema:
type: boolean
- description: When `type`==`ap`, Port speed of eth0. Accepts multiple comma-separated integer values.
in: query
name: eth0_port_speed
schema:
examples:
- 100,1000
- 100
- 1000
type: integer
- description: When `type`==`switch`, EVPN topology id
in: query
name: evpntopo_id
schema:
format: uuid
type: string
- 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.
in: query
name: ext_ip
schema:
examples:
- 1.2.3.4,1.2.3.*
- 1.2.3.4
- 1.2.3.*
- '*2.3.*'
type: string
- 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.
in: query
name: hostname
schema:
examples:
- my-london-1,my-london*
- my-london-1
- my-london*
- '*london*'
type: string
- 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.
in: query
name: ip
schema:
examples:
- 10.100.10.54,10.100.10.*
- 10.100.10.54
- 10.100.10.*
- '*100.10.*'
type: string
- description: When `type`==`switch` or `type`==`gateway`, last configuration status
in: query
name: last_config_status
schema:
examples:
- success
type: string
- description: Last hostname of the device. Accepts multiple comma-separated values.
in: query
name: last_hostname
schema:
examples:
- ap-01,ap-02
type: string
- description: When `type`==`ap`, LLDP management IP address. Accepts multiple comma-separated values.
in: query
name: lldp_mgmt_addr
schema:
examples:
- 192.0.2.10,192.0.2.11
type: string
- 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.
in: query
name: lldp_port_id
schema:
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
type: string
- $ref: '#/components/parameters/partial_filter_lldp_system_desc'
- 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.
in: query
name: lldp_system_name
schema:
examples:
- richmond-hill-switch,Phoenix_Switch
type: string
- 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.
in: query
name: mac
schema:
examples:
- aabbccddeeff,aabbcc*
- aabbccddeeff
- aabbcc*
- '*bbcc*'
type: string
- 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.
in: query
name: model
schema:
examples:
- AP43,AP4*
- AP43
- AP4*
- '*P4*'
type: string
- description: When `type`==`ap`, Mist Edge id, if AP is connecting to a Mist Edge. Accepts multiple comma-separated values.
in: query
name: mxedge_id
schema:
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
format: uuid
type: string
- description: When `type`==`ap`, Comma separated list of Mist Edge id, if AP is connecting to a Mist Edge
in: query
name: mxedge_ids
schema:
type: string
- description: 'When `type`==`ap`, Mist Tunnel status used to filter results. enum: `down`, `up`'
in: query
name: mxtunnel_status
schema:
$ref: '#/components/schemas/search_org_devices_mxtunnel_status'
- description: 'When `type`==`gateway`. enum: `node0`, `node1`'
in: query
name: node
schema:
$ref: '#/components/schemas/ha_cluster_node_enum'
- description: When `type`==`gateway`, node0 MAC address
in: query
name: node0_mac
schema:
type: string
- description: When `type`==`gateway`, node1 MAC address
in: query
name: node1_mac
schema:
type: string
- description: When `type`==`ap`, whether the AP is power constrained.
in: query
name: power_constrained
schema:
type: boolean
- description: "When `type`==`switch` or `type`==`gateway`, Key-value pairs where the key\nis the RADIUS server address and the value contains authentication statistics:\n * <server_address> (string): IP address of the RADIUS server as the key\n * `auth_accepts` (long): Number of accepted authentication requests\n * `auth_rejects` (long): Number of rejected authentication requests\n * `auth_timeouts` (long): Number of authentication timeouts\n * `auth_server_status` (string): Status of the server. Possible values: `up`, `down`, `unreachable`"
in: query
name: radius_stats
schema:
type: string
- description: Filter results by site identifier
in: query
name: site_id
schema:
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
type: string
- description: Whether to return device stats
in: query
name: stats
schema:
default: false
type: boolean
- description: When `type`==`gateway` (SSR only), version of 128T agent
in: query
name: t128agent_version
schema:
type: string
- $ref: '#/components/parameters/device_type'
- description: Filter results by software version. Accepts multiple comma-separated values.
in: query
name: version
schema:
examples:
- 0.15.34615,0.14.29967
type: string
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/duration'
- $ref: '#/components/parameters/sort'
- $ref: '#/components/parameters/search_after'
responses:
'200':
$ref: '#/components/responses/DevicesSearch'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: searchOrgDevices
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/summary:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: Return aggregate organization device counts by device category and assignment state.
operationId: listOrgDevicesSummary
responses:
'200':
$ref: '#/components/responses/OrgDevicesSummary'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listOrgDevicesSummary
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/ocdevices/outbound_ssh_cmd:
parameters:
- $ref: '#/components/parameters/org_id'
get:
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:
- description: Filter results by site identifier
in: query
name: site_id
schema:
type: string
responses:
'200':
$ref: '#/components/responses/JunosRegisterCmd'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: getOrgJuniperDevicesCommand
tags:
- Orgs Devices
components:
schemas:
response_device_search_results_items:
description: Device search record for an AP, switch, or gateway
oneOf:
- $ref: '#/components/schemas/ap_search'
- $ref: '#/components/schemas/switch_search'
- $ref: '#/components/schemas/gateway_search'
org_id:
description: Unique identifier of a Mist organization
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
format: uuid
readOnly: true
type: string
ap_radio_mac:
additionalProperties: false
description: Access point MAC address and its related radio MAC addresses
examples:
- mac: 5c5b350001a0
radio_macs:
- 5c5b350001a0
- 5c5b350001a1
properties:
mac:
description: Access point MAC address for this radio MAC mapping
examples:
- 5c5b350001a0
minLength: 1
type: string
radio_macs:
$ref: '#/components/schemas/ap_radio_mac_radio_macs'
description: List of radio MAC addresses associated with this access point
required:
- mac
- radio_macs
type: object
device_events:
description: List of device event payloads
items:
$ref: '#/components/schemas/device_event'
type: array
uniqueItems: true
search_org_devices_mxtunnel_status:
description: 'Mist Tunnel status filter for organization device search. enum: `down`, `up`'
enum:
- down
- up
type: string
response_device_search_results:
description: Device search records for APs, switches, or gateways
items:
$ref: '#/components/schemas/response_device_search_results_items'
type: array
uniqueItems: true
ap_search:
additionalProperties: false
description: Access point record returned by device search endpoints
properties:
band_24_bandwidth:
description: Current channel bandwidth on the AP 2.4 GHz radio
type: string
band_24_channel:
description: Current channel on the AP 2.4 GHz radio
type: integer
band_24_power:
description: Current transmit power on the AP 2.4 GHz radio
type: integer
band_5_bandwidth:
description: Current channel bandwidth on the AP 5 GHz radio
type: string
band_5_channel:
description: Current channel on the AP 5 GHz radio
type: integer
band_5_power:
description: Current transmit power on the AP 5 GHz radio
ty
# --- truncated at 32 KB (80 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mist/refs/heads/main/openapi/mist-orgs-devices-api-openapi.yml