Juniper Mist AI Sites SLEs API

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.

OpenAPI Specification

mist-ai-sites-sles-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  contact:
    email: tmunzer@juniper.net
    name: Thomas Munzer
  description: '> Version: **2604.1.1**

    >

    > Date: **May 13, 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 Admins Sites SLEs API
  version: 2604.1.1
  x-logo:
    altText: Juniper-MistAI
    backgroundColor: '#FFFFFF'
    url: https://www.mist.com/wp-content/uploads/logo.png
servers:
- description: Mist Global 01
  url: https://api.mist.com
- description: Mist Global 02
  url: https://api.gc1.mist.com
- description: Mist Global 03
  url: https://api.ac2.mist.com
- description: Mist Global 04
  url: https://api.gc2.mist.com
- description: Mist Global 05
  url: https://api.gc4.mist.com
- description: Mist EMEA 01
  url: https://api.eu.mist.com
- description: Mist EMEA 02
  url: https://api.gc3.mist.com
- description: Mist EMEA 03
  url: https://api.ac6.mist.com
- description: Mist EMEA 04
  url: https://api.gc6.mist.com
- description: Mist APAC 01
  url: https://api.ac5.mist.com
- description: Mist APAC 02
  url: https://api.gc5.mist.com
- description: Mist APAC 03
  url: https://api.gc7.mist.com
security:
- apiToken: []
- basicAuth: []
- basicAuth: []
  csrfToken: []
tags:
- description: '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 SLEs
paths:
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/classifier/{classifier}/summary:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/sle_summary_scope'
    - description: '* site_id if `scope`==`site`

        * device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`

        * mac if `scope`==`client`'
      in: path
      name: scope_id
      required: true
      schema:
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        type: string
    - in: path
      name: classifier
      required: true
      schema:
        type: string
    get:
      deprecated: true
      description: 'Get SLE classifier details



        This API Endpoint is deprecated and replaced by [Get Site SLE Classifier Summary Trend](/#operations/getSiteSleClassifierSummaryTrend)'
      operationId: getSiteSleClassifierDetails
      parameters:
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - $ref: '#/components/parameters/duration'
      responses:
        '200':
          $ref: '#/components/responses/SleClassifierSummary'
        '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: getSiteSleClassifierDetails
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/classifier/{classifier}/summary-trend:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/sle_summary_scope'
    - description: '* site_id if `scope`==`site`

        * device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`

        * mac if `scope`==`client`'
      in: path
      name: scope_id
      required: true
      schema:
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        type: string
    - in: path
      name: classifier
      required: true
      schema:
        type: string
    get:
      description: Get SLE classifier Summary Trend
      operationId: getSiteSleClassifierSummaryTrend
      parameters:
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - $ref: '#/components/parameters/duration'
      responses:
        '200':
          $ref: '#/components/responses/SleClassifierSummaryTrend'
        '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: getSiteSleClassifierSummaryTrend
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/classifiers:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/site_sle_metric_classifiers_scope_parameters'
    - description: '* site_id if `scope`==`site`

        * device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`

        * mac if `scope`==`client`'
      in: path
      name: scope_id
      required: true
      schema:
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        type: string
    get:
      description: List classifiers for a specific metric
      operationId: listSiteSleMetricClassifiers
      responses:
        '200':
          content:
            application/json:
              examples:
                example:
                  value:
                  - asymmetry-uplink
                  - weak-signal
                  - asymmetry-downlink
              schema:
                $ref: '#/components/schemas/strings'
          description: OK
        '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: listSiteSleMetricClassifiers
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/histogram:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/site_sle_histogram_scope_parameters'
    - description: '* site_id if `scope`==`site`

        * device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`

        * mac if `scope`==`client`'
      in: path
      name: scope_id
      required: true
      schema:
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        type: string
    get:
      description: Get the histogram for the SLE metric
      operationId: getSiteSleHistogram
      parameters:
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - $ref: '#/components/parameters/duration'
      responses:
        '200':
          $ref: '#/components/responses/SleHistogram'
        '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: getSiteSleHistogram
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impact-summary:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/site_sle_impact_summary_scope_parameters'
    - description: '* site_id if `scope`==`site`

        * device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`

        * mac if `scope`==`client`'
      in: path
      name: scope_id
      required: true
      schema:
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        type: string
    get:
      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:
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - $ref: '#/components/parameters/duration'
      - in: query
        name: fields
        schema:
          $ref: '#/components/schemas/site_sle_impact_summary_fields_parameter'
      - in: query
        name: classifier
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/SleImpactSummary'
        '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: getSiteSleImpactSummary
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-applications:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/site_sle_scope'
    - in: path
      name: scope_id
      required: true
      schema:
        format: uuid
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        type: string
    get:
      description: For WAN SLEs. List the impacted interfaces optionally filtered by classifier and failure type
      operationId: listSiteSleImpactedApplications
      parameters:
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - $ref: '#/components/parameters/duration'
      - in: query
        name: classifier
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/SleImpactedApplications'
        '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: listSiteSleImpactedApplications
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-aps:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/site_sle_impacted_aps_scope_parameters'
    - in: path
      name: scope_id
      required: true
      schema:
        format: uuid
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        type: string
    get:
      description: For Wireless SLEs. List the impacted APs optionally filtered by classifier and failure type
      operationId: listSiteSleImpactedAps
      parameters:
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - $ref: '#/components/parameters/duration'
      - in: query
        name: classifier
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/SleImpactedAps'
        '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: listSiteSleImpactedAps
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-chassis:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/site_sle_impacted_chassis_scope_parameters'
    - in: path
      name: scope_id
      required: true
      schema:
        format: uuid
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        type: string
    get:
      description: For Wired and WAN SLEs. List the impacted interfaces optionally filtered by classifier and failure type
      operationId: listSiteSleImpactedChassis
      parameters:
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - $ref: '#/components/parameters/duration'
      - in: query
        name: classifier
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/SleImpactedChassis'
        '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: listSiteSleImpactedChassis
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-clients:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/site_sle_impacted_clients_scope_parameters'
    - in: path
      name: scope_id
      required: true
      schema:
        format: uuid
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        type: string
    get:
      description: For Wired SLEs. List the impacted interfaces optionally filtered by classifier and failure type
      operationId: listSiteSleImpactedWiredClients
      parameters:
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - $ref: '#/components/parameters/duration'
      - in: query
        name: classifier
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/SleImpactedClients'
        '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: listSiteSleImpactedWiredClients
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-gateways:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/site_sle_impacted_gateways_scope_parameters'
    - in: path
      name: scope_id
      required: true
      schema:
        format: uuid
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        type: string
    get:
      description: For WAN SLEs. List the impacted interfaces optionally filtered by classifier and failure type
      operationId: listSiteSleImpactedGateways
      parameters:
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - $ref: '#/components/parameters/duration'
      - in: query
        name: classifier
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/SleImpactedGateways'
        '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: listSiteSleImpactedGateways
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-interfaces:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/site_sle_impacted_interfaces_scope_parameters'
    - in: path
      name: scope_id
      required: true
      schema:
        format: uuid
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        type: string
    get:
      description: For Wired and WAN SLEs. List the impacted interfaces optionally filtered by classifier and failure type
      operationId: listSiteSleImpactedInterfaces
      parameters:
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - $ref: '#/components/parameters/duration'
      - in: query
        name: classifier
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/SleImpactedInterfaces'
        '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: listSiteSleImpactedInterfaces
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-switches:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/site_sle_impacted_switches_scope_parameters'
    - in: path
      name: scope_id
      required: true
      schema:
        format: uuid
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        type: string
    get:
      description: For Wired SLEs. List the impacted switches optionally filtered by classifier and failure type
      operationId: listSiteSleImpactedSwitches
      parameters:
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - $ref: '#/components/parameters/duration'
      - in: query
        name: classifier
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/SleImpactedSwitches'
        '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: listSiteSleImpactedSwitches
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-users:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/site_sle_impacted_users_scope_parameter'
    - in: path
      name: scope_id
      required: true
      schema:
        format: uuid
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        type: string
    get:
      description: For Wireless SLEs. List the impacted wireless users optionally filtered by classifier and failure type
      operationId: listSiteSleImpactedWirelessClients
      parameters:
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - $ref: '#/components/parameters/duration'
      - in: query
        name: classifier
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/SleImpactedUsers'
        '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: listSiteSleImpactedWirelessClients
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/summary:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/site_sle_metric_summary_scope_parameters'
    - description: '* site_id if `scope`==`site`

        * device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`

        * mac if `scope`==`client`'
      in: path
      name: scope_id
      required: true
      schema:
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        type: string
    get:
      deprecated: true
      description: 'Get the summary for the SLE metric



        This API Endpoint is deprecated and replaced by [Get Site SLE Summary Trend](/#operations/getSiteSleSummaryTrend)'
      operationId: getSiteSleSummary
      parameters:
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - $ref: '#/components/parameters/duration'
      responses:
        '200':
          $ref: '#/components/responses/SleSummary'
        '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: getSiteSleSummary
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/summary-trend:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/site_sle_metric_summary_scope_parameters'
    - description: '* site_id if `scope`==`site`

        * device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`

        * mac if `scope`==`client`'
      in: path
      name: scope_id
      required: true
      schema:
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        type: string
    get:
      description: Get the summary for the SLE metric trend
      operationId: getSiteSleSummaryTrend
      parameters:
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/end'
      - $ref: '#/components/parameters/duration'
      responses:
        '200':
          $ref: '#/components/responses/SleSummaryTrend'
        '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: getSiteSleSummaryTrend
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/threshold:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/site_sle_threshold_scope_parameter'
    - description: '* site_id if `scope`==`site`

        * device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`

        * mac if `scope`==`client`'
      in: path
      name: scope_id
      required: true
      schema:
        examples:
        - 000000ab-00ab-00ab-00ab-0000000000ab
        type: string
    - description: Values from `listSiteSlesMetrics`
      in: path
      name: metric
      required: true
      schema:
        examples:
        - asymmetry-uplink
        type: string
    get:
      description: Get the SLE threshold
      operationId: getSiteSleThreshold
      responses:
        '200':
          $ref: '#/components/responses/SleThreshold'
        '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: getSiteSleThreshold
      tags:
      - Sites SLEs
    post:
      description: Replace the SLE threshold
      operationId: replaceSiteSleThreshold
      requestBody:
        content:
          application/json:
            examples:
              Example:
                value:
                  maximum: -60
                  minimum: -90
            schema:
              $ref: '#/components/schemas/sle_threshold'
      responses:
        '200':
          $ref: '#/components/responses/SleThreshold'
        '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: replaceSiteSleThreshold
      tags:
      - Sites SLEs
    put:
      description: Update the SLE threshold
      operationId: updateSiteSleThreshold
      requestBody:
        content:
          application/json:
            examples:
              Example:
                value:
                  maximum: -60
                  minimum: -90
            schema:
              $ref: '#/components/schemas/sle_threshold'
      responses:
        '200':
          $ref: '#/components/responses/SleThreshold'
        '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: updateSiteSleThreshold
      tags:
      - Sites SLEs
  /api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metrics:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - in: path
      name: scope
      required: true
      schema:
        $ref: '#/components/schemas/site_sle_metrics_scope_parameters'
    - description: '* site_id if `scope`==`site`

        * device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`

        * mac if `scope`==`client`'
      in: path
      name: scope_id
      required: true
      schema:
        type: string
    get:
      description: List the metrics for the given scope
      operationId: listSiteSlesMetrics
      responses:
        '200':
          $ref: '#/components/responses/SiteSleMetrics'
        '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: listSiteSlesMetrics
      tags:
      - Sites SLEs
components:
  schemas:
    sle_classifier:
      additionalProperties: false
      properties:
        impact:
          $ref: '#/components/schemas/sle_classifier_impact'
        interval:
          type: number
        name:
          minLength: 1
          type: string
        samples:
          $ref: '#/components/schemas/sle_classifier_samples'
        x_label:
          minLength: 1
          type: string
        y_label:
          minLength: 1
          type: string
      required:
      - name
      - x_label
      - y_label
      - interval
      - impact
      type: object
    site_sle_impacted_switches_scope_parameters:
      description: 'enum: `site`'
      enum:
      - site
      type: string
    sle_classifier_summary:
      additionalProperties: false
      deprecated: true
      properties:
        classifier:
          $ref: '#/components/schemas/sle_classifier'
        end:
          type: number
        failures:
          $ref: '#/components/schemas/sle_classifier_summary_failures'
        impact:
          $ref: '#/components/schemas/sle_classifier_summary_impact'
        metric:
          minLength: 1
          type: string
        start:
          type: number
      required:
      - start
      - end
      - metric
      - classifier
      - impact
      - failures
      type: object
    strings:
      items:
        type: string
      type: array
      uniqueItems: true
    sle_classifier_samples_degraded:
      items:
        $ref: '#/components/schemas/number_or_null'
      type: array
    sle_impact_summary_device_type_item:
      additionalProperties: false
      properties:
        degraded:
          type: number
        device_type:
          type: string
        duration:
          type: number
        name:
          minLength: 1
          type: string
        total:
          type: number
      required:
      - device_type
      - name
      - duration
      - degraded
      - total
      type: object
    sle_summary_events:
      items:
        additionalProperties: true
        type: object
      type: array
    sle_classifier_samples:
      additionalProperties: false
      properties:
        degraded:
          $ref: '#/components/schemas/sle_classifier_samples_degraded'
        duration:
          $ref: '#/components/schemas/sle_classifier_samples_duration'
        total:
          $ref: '#/components/schemas/sle_classifier_samples_total'
      required:
      - duration
      - total
      - degraded
      type: object
    site_sle_scope:
      description: 'enum: `gateway`, `site`, `switch`'
      enum:
      - gateway
      - site
      - switch
      type: string
    

# --- truncated at 32 KB (98 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mist-ai/refs/heads/main/openapi/mist-ai-sites-sles-api-openapi.yml