{
  "opencollection": "1.0.0",
  "info": {
    "name": "Mist Admins Sites Stats - Discovered Switches API",
    "version": "2606.1.1"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "Authorization",
      "value": "{{Authorization}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Sites Stats - Discovered Switches",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "searchSiteDiscoveredSwitchesMetrics",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mist.com/api/v1/sites/:site_id/stats/discovered_switch_metrics/search",
            "params": [
              {
                "name": "site_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "scope",
                "value": "",
                "type": "query",
                "description": "Filter results by scope. enum: `site`, `switch`"
              },
              {
                "name": "type",
                "value": "",
                "type": "query",
                "description": "Metric type. enum: `inactive_wired_vlans`, `poe_compliance`, `switch_ap_affinity`, `version_compliance`"
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Maximum number of results to return per page"
              },
              {
                "name": "start",
                "value": "",
                "type": "query",
                "description": "Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`"
              },
              {
                "name": "end",
                "value": "",
                "type": "query",
                "description": "Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`"
              },
              {
                "name": "duration",
                "value": "",
                "type": "query",
                "description": "Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`"
              },
              {
                "name": "sort",
                "value": "",
                "type": "query",
                "description": "On which field the list should be sorted, -prefix represents DESC order"
              },
              {
                "name": "search_after",
                "value": "",
                "type": "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."
              }
            ]
          },
          "docs": "Search Discovered Switch Metrics"
        },
        {
          "info": {
            "name": "countSiteDiscoveredSwitches",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mist.com/api/v1/sites/:site_id/stats/discovered_switches/count",
            "params": [
              {
                "name": "site_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "distinct",
                "value": "",
                "type": "query",
                "description": "Field used to group this count response. enum: `mgmt_addr`, `model`, `system_name`, `version`"
              },
              {
                "name": "start",
                "value": "",
                "type": "query",
                "description": "Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`"
              },
              {
                "name": "end",
                "value": "",
                "type": "query",
                "description": "Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`"
              },
              {
                "name": "duration",
                "value": "",
                "type": "query",
                "description": "Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`"
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Maximum number of results to return per page"
              }
            ]
          },
          "docs": "Count Discovered Switches"
        },
        {
          "info": {
            "name": "listSiteDiscoveredSwitchesMetrics",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mist.com/api/v1/sites/:site_id/stats/discovered_switches/metrics",
            "params": [
              {
                "name": "site_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "threshold",
                "value": "",
                "type": "query",
                "description": "Configurable # ap per switch threshold, default 12"
              },
              {
                "name": "system_name",
                "value": "",
                "type": "query",
                "description": "System name for switch level metrics, optional"
              }
            ]
          },
          "docs": "Discovered switches related metrics, lists related switch system names & details if not compliant"
        },
        {
          "info": {
            "name": "searchSiteDiscoveredSwitches",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mist.com/api/v1/sites/:site_id/stats/discovered_switches/search",
            "params": [
              {
                "name": "site_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "adopted",
                "value": "",
                "type": "query",
                "description": "Filter results by whether the device is adopted"
              },
              {
                "name": "system_name",
                "value": "",
                "type": "query",
                "description": "Filter discovered switch results by system name"
              },
              {
                "name": "hostname",
                "value": "",
                "type": "query",
                "description": "Filter results by hostname"
              },
              {
                "name": "vendor",
                "value": "",
                "type": "query",
                "description": "Filter results by vendor"
              },
              {
                "name": "model",
                "value": "",
                "type": "query",
                "description": "Filter results by device model"
              },
              {
                "name": "version",
                "value": "",
                "type": "query",
                "description": "Filter results by software version"
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Maximum number of results to return per page"
              },
              {
                "name": "start",
                "value": "",
                "type": "query",
                "description": "Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`"
              },
              {
                "name": "end",
                "value": "",
                "type": "query",
                "description": "Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`"
              },
              {
                "name": "duration",
                "value": "",
                "type": "query",
                "description": "Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`"
              },
              {
                "name": "sort",
                "value": "",
                "type": "query",
                "description": "On which field the list should be sorted, -prefix represents DESC order"
              },
              {
                "name": "search_after",
                "value": "",
                "type": "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."
              }
            ]
          },
          "docs": "Search Discovered Switches"
        }
      ]
    }
  ],
  "bundled": true
}