Extreme Networks D360 API

openapi: 3.2.0
info:
  title: ExtremeCloud IQ Account D360 API
  description: 'ExtremeCloud IQ™ API allows customers and partners to create solutions for the management, monitoring, and provisioning

    of any ExtremeCloud IQ™ environment.


    All related resources and documentation are available at [ExtremeCloud IQ Developer Portal](https://developer.extremecloudiq.com/).

    Please check [Get Started and Tutorial](https://developer.extremecloudiq.com/documentation/) to understand how to use the APIs.


    Get the [latest OpenAPI definition](https://github.com/extremenetworks/ExtremeCloudIQ-OpenAPI/blob/main/xcloudiq-openapi.yaml)

    from [ExtremeCloud IQ OpenAPI GitHub repository](https://github.com/extremenetworks/ExtremeCloudIQ-OpenAPI).


    Please have a valid [ExtremeCloud IQ](https://extremecloudiq.com/) account before getting started.

    If you don''t have one, please [register a new account](https://www.extremenetworks.com/cloud-networking/).'
  termsOfService: https://www.extremenetworks.com/company/legal/terms-of-use/
  contact:
    name: Extreme Networks Support
    url: https://www.extremenetworks.com/support
    email: support@extremenetworks.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  version: 25.9.0-36
servers:
- url: https://api.extremecloudiq.com
  description: ExtremeCloud IQ REST API Server
tags:
- name: D360
  description: Device 360
paths:
  /d360/wireless/surrounding-aps:
    post:
      tags:
      - D360
      summary: Surrounding APs
      description: Get a list of surrounding APs.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_wireless_surrounding_aps
      operationId: surroundingAps
      parameters:
      - name: deviceId
        in: query
        description: The device ID
        required: true
        schema:
          type: integer
          format: int64
      - $ref: '#/components/parameters/startTime'
      - $ref: '#/components/parameters/endTime'
      - $ref: '#/components/parameters/selectedTime'
      - $ref: '#/components/parameters/page'
      - $ref: '#/components/parameters/limit'
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                numberFilters:
                  type: object
                  description: The number based column filters available(Available columns- Channel width, rssi, channel utilization %, number of clients ).
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/number_filter'
                ssids:
                  description: The ssids available
                  type: array
                  items:
                    type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagedRmSurroundingAps'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/wireless/interfaces-stats:
    get:
      tags:
      - D360
      summary: Wireless Interfaces Stats
      description: Get Statistics of wireless interfaces of a device.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_wireless_interfaces_stats
      operationId: wirelessInterfacesStats
      parameters:
      - name: deviceId
        in: query
        description: The device ID
        required: true
        schema:
          type: integer
          format: int64
      - $ref: '#/components/parameters/startTime'
      - $ref: '#/components/parameters/endTime'
      - $ref: '#/components/parameters/selectedTime'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RmWirelessInterfacesList'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/overview/devices-summary:
    get:
      tags:
      - D360
      summary: Get Device Summary
      description: List the summary of device details.
      externalDocs:
        description: API Reference
        url: http://extremecloudiq.com/api-docs/api-reference.html#_get_device_summary
      operationId: getDeviceSummary
      parameters:
      - name: deviceId
        in: query
        description: The device ID
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RmDeviceSummary'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/overview/devices-location:
    get:
      tags:
      - D360
      summary: Get Device Geo Location
      description: Get the geographical location of device.
      externalDocs:
        description: API Reference
        url: http://extremecloudiq.com/api-docs/api-reference.html#_get_device_geo_location
      operationId: getDeviceGeoLocation
      parameters:
      - name: deviceId
        in: query
        description: The device ID
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RmDeviceGeoLocation'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/alert/graph:
    get:
      tags:
      - D360
      summary: Alerts Graph
      description: List a list of alerts for Graphing API.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_alert_graph
      operationId: alertsGraph
      parameters:
      - $ref: '#/components/parameters/startTime'
      - $ref: '#/components/parameters/endTime'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphResponse'
  /d360/client/graph:
    post:
      tags:
      - D360
      summary: Client Graph
      description: List a list of connected clients for Graphing API of D360.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_client_graph
      operationId: clientsGraph
      parameters:
      - name: deviceId
        in: query
        description: The device ID
        required: true
        schema:
          type: integer
          format: int64
      - $ref: '#/components/parameters/startTime'
      - $ref: '#/components/parameters/endTime'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                filter_name:
                  description: List of available filters for clients graph
                  type: array
                  items:
                    $ref: '#/components/schemas/RmClientGraphFilterType'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                description: The graph response based on filters.
                items:
                  $ref: '#/components/schemas/RmClientGraphResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/device-metadata:
    get:
      tags:
      - D360
      summary: Device metadata
      description: The device metadata like timestamp from which device is online and location.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_get_connected_since
      operationId: connectedSince
      parameters:
      - name: deviceId
        in: query
        description: The device ID
        required: true
        schema:
          type: integer
          format: int64
      - name: deviceType
        in: query
        description: The device type (wired/wireless)
        schema:
          $ref: '#/components/schemas/XiqDeviceType'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  device_data:
                    $ref: '#/components/schemas/RmDeviceData'
                  device_path:
                    type: object
                    properties:
                      folder_path_info:
                        type: array
                        items:
                          $ref: '#/components/schemas/RmDevicePathInfo'
                  network_policy:
                    type: object
                    description: The network policy attached to device
                    properties:
                      policy_id:
                        description: The policy Id.
                        type: integer
                        format: int64
                      policy_name:
                        description: The policy Name
                        type: string
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/installation/media:
    post:
      tags:
      - D360
      summary: Installation Media-upload
      description: Upload installation media.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_upload_media
      operationId: uploadMedia
      requestBody:
        description: The request body to upload the installation media.
        content:
          application/json:
            schema:
              type: object
              properties:
                filePath:
                  description: The path of the file(.png/.jpg or .mp4/.mov)
                  type: string
                title:
                  description: The title of the the file
                  type: string
                fileDescription:
                  description: The description of the file
                  type: string
      responses:
        '200':
          description: Returns the response of the client health grid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RmMediaUploadResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
    delete:
      tags:
      - D360
      summary: Installation Media-delete
      description: Delete installation media.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_delete_media
      operationId: deleteMedia
      parameters:
      - name: mediaId
        in: query
        description: The id of the media file
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: OK
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/wired/interface-grid:
    get:
      tags:
      - D360
      summary: Wired Interfaces
      description: Wired Interfaces -Grid.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_wired_interfaces_grid
      operationId: wiredGrid
      parameters:
      - name: deviceId
        in: query
        description: The device ID
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: Returns the response of the wired interfaces grid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RmWiredInterfaceGrid'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/device/location:
    get:
      tags:
      - D360
      summary: Device Location
      description: Retrieves the device location details on the map for the device.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_device_location
      operationId: deviceLocation
      parameters:
      - name: deviceId
        in: query
        description: The device ID
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: Returns the response of the device location
          content:
            application/json:
              schema:
                type: object
                properties:
                  folder_id:
                    type: integer
                    description: Unique identifier for the folder.
                  device_id:
                    type: integer
                    description: Unique identifier for the device.
                  device_mac_address:
                    type: string
                    description: MAC address of the device.
                  device_hostname:
                    type: string
                    description: Hostname of the device.
                  device_type:
                    type: string
                    description: Type of the device.
                  device_function:
                    type: string
                    description: Function of the device.
                  x:
                    type: number
                    format: double
                    description: X-coordinate of the device location.
                  y:
                    type: number
                    format: double
                    description: Y-coordinate of the device location.
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/device/issues:
    get:
      tags:
      - D360
      summary: Device Issues
      description: Retrieves the various issues for device.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_device_issues
      operationId: deviceIssues
      parameters:
      - name: deviceId
        in: query
        description: The device ID
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: Returns the response of the device issues
          content:
            application/json:
              schema:
                type: object
                properties:
                  association_failures:
                    type: integer
                    description: The number of association failures.
                  authentication_failures:
                    type: integer
                    description: The number of authentication failures.
                  ip_address_issues:
                    type: integer
                    description: The number of IP Address issues.
                  excessive_packet_loss_ap_count:
                    type: integer
                    format: int64
                    description: Count of APs with excessive packet loss
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/device/stats:
    get:
      tags:
      - D360
      summary: Device Stats
      description: Grid of Device Stats.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_wireless_interfaces_graph
      operationId: deviceStats
      parameters:
      - name: deviceId
        in: query
        description: The device ID
        required: true
        schema:
          type: integer
          format: int64
      - $ref: '#/components/parameters/startTime'
      - $ref: '#/components/parameters/endTime'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                description: The graph response based on filters.
                items:
                  $ref: '#/components/schemas/XiqDeviceHealthGridResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/wireless/interfaces-graph:
    get:
      tags:
      - D360
      summary: Wireless Interfaces Graph
      description: List a list of wireless interfaces metrics for Graphing API.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_wireless_interfaces_graph
      operationId: wirelessInterfacesGraph
      parameters:
      - name: deviceId
        in: query
        description: The device ID
        required: true
        schema:
          type: integer
          format: int64
      - $ref: '#/components/parameters/startTime'
      - $ref: '#/components/parameters/endTime'
      - name: channel
        in: query
        description: The channel filters.
        required: true
        schema:
          $ref: '#/components/schemas/RmChannelFilterType'
      - name: source
        in: query
        description: The source filters.
        required: true
        schema:
          $ref: '#/components/schemas/RmSourceFilterType'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                description: The graph response based on filters.
                items:
                  $ref: '#/components/schemas/RmWirelessInterfacesGraphResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/client/stats:
    get:
      tags:
      - D360
      summary: Client Stats
      description: Client statistics.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_client_stats
      operationId: clientStats
      parameters:
      - name: deviceId
        in: query
        description: The device ID
        required: true
        schema:
          type: integer
          format: int64
      - $ref: '#/components/parameters/startTime'
      - $ref: '#/components/parameters/endTime'
      responses:
        '200':
          description: Returns the client statistics.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RmClientStats'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/device/interfaces:
    get:
      tags:
      - D360
      summary: Wireless Interfaces per device
      description: List available wifi interfaces on device model.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_device_interfaces
      operationId: deviceInterfaces
      parameters:
      - name: deviceModel
        in: query
        description: The model of device
        required: true
        schema:
          $ref: '#/components/schemas/RmDevices'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                description: The available interfaces for the device.
                items:
                  $ref: '#/components/schemas/RmDeviceInterfaces'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/client/grid:
    get:
      tags:
      - D360
      summary: Client Grid
      description: List a list of connected clients for Graphing API of D360.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_client_graph
      operationId: clientGrid
      parameters:
      - $ref: '#/components/parameters/page'
      - $ref: '#/components/parameters/limit'
      - name: keyword
        in: query
        description: The keyword to search
        required: false
        schema:
          type: string
      - name: deviceId
        in: query
        description: The device ID
        required: true
        schema:
          type: integer
          format: int64
      - $ref: '#/components/parameters/startTime'
      - $ref: '#/components/parameters/endTime'
      - $ref: '#/components/parameters/selectedTime'
      - name: clientStatus
        in: query
        description: The client statistics filter.
        required: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/RmClientStatisticsFilter'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagedRmD360ClientGrid'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/wireless/surrounding-aps/ssid-metadata:
    get:
      tags:
      - D360
      summary: SSID metadata of surrounding APs
      description: Grid of Device Stats.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_ssid_metadata
      operationId: ssidMetadata
      parameters:
      - name: deviceId
        in: query
        description: The device ID
        required: true
        schema:
          type: integer
          format: int64
      - $ref: '#/components/parameters/startTime'
      - $ref: '#/components/parameters/endTime'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                description: The available ssids of the surrounding APs of the device
                items:
                  type: string
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
  /d360/event/graph:
    get:
      tags:
      - D360
      summary: Events Graph
      description: Retrieve a time-series graph of event metrics. Each timestamp includes an array of event types with their respective counts. Only selected filters will be included in the response.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_event_graph
      operationId: eventsGraph
      parameters:
      - $ref: '#/components/parameters/startTime'
      - $ref: '#/components/parameters/endTime'
      - name: deviceId
        in: query
        description: The device ID
        required: true
        schema:
          type: integer
          format: int64
      - name: filter
        in: query
        description: 'Filter events by type. Only selected event types will be included in the response. Valid values: `CRITICAL`, `MAJOR`, `MINOR`, `INFO`, `ACTIVE`, `CLEARED`, `ALL`.

          '
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - CRITICAL
            - MAJOR
            - MINOR
            - INFO
            - ACTIVE
            - CLEARED
            - ALL
          uniqueItems: true
          example:
          - CRITICAL
          - MAJOR
        style: form
        explode: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                description: The Graph metric response.
                properties:
                  data:
                    type: array
                    description: List of event metrics grouped by timestamp.
                    items:
                      type: object
                      properties:
                        timestamp:
                          type: integer
                          format: int64
                          description: The timestamp of the event metric (Unix epoch in ms).
                        events:
                          type: array
                          description: List of event types and their counts.
                          items:
                            type: object
                            properties:
                              event_name:
                                type: string
                                enum:
                                - CRITICAL
                                - MAJOR
                                - MINOR
                                - INFO
                                - ACTIVE
                                - CLEARED
                                - ALL
                                description: The name of the event type.
                              count:
                                type: integer
                                format: int64
                                description: Number of events of this type at the timestamp.
  /d360/wired/queue-grid:
    get:
      tags:
      - D360
      summary: Wired QOS queue grid
      description: Returns all QOS queue statistics for a wired device.
      externalDocs:
        description: API Reference
        url: https://extremecloudiq.com/api-docs/api-reference.html#_get_wired_queue_grid
      operationId: wiredQueueGrid
      parameters:
      - $ref: '#/components/parameters/page'
      - $ref: '#/components/parameters/limit'
      - name: deviceId
        in: query
        description: The unique device identifier. It can be virtual slot id and all stack ports will be returned or a member slot id and only that slot ports will be returned.
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: Returns all QOS queue statistics for a wired device
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagedRmWiredQueueGridResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - BearerAuth: []
components:
  schemas:
    XiqDeviceLicenseTier:
      type: string
      description: The Device License Tier Enum.
      enum:
      - NOT_APPLICABLE
      - TIER_A
      - TIER_B
      - TIER_C
      - TIER_D
      - UNKNOWN
      - NONE
    RmWirelessInterfacesList:
      type: array
      description: The WiFi interface list.
      items:
        type: object
        properties:
          wifi0:
            $ref: '#/components/schemas/RmWifiIntStats'
            description: Stats of WiFi interface 0
          wifi1:
            $ref: '#/components/schemas/RmWifiIntStats'
            description: Stats of WiFi interface 1
          wifi2:
            description: Stats of WiFi interface 2
            allOf:
            - $ref: '#/components/schemas/RmWifiIntStats'
            - type: object
              properties:
                afc_status:
                  $ref: '#/components/schemas/XiqAfcApStatus'
    RmDevices:
      title: RmDevices
      description: The devices supported with IQE.
      enum:
      - AP_650
      - AP_650X
      - AP_4000
      - AP_4000U
      - AP_302W
      - AP_510C
      - AP_510CX
      - AP_410C
      - AP_460C
      - AP_305C
      - AP_305CX
      - AP_460S6C
      - AP_460S12C
      - AP_5010
      - AP_5010U
      - AP_5050U
      - AP_5050D
      - AP_3000
      - AP_3000X
      - AP_5020
      example: AP_650
    RmDeviceInterfaces:
      type: string
      title: XiqDeviceType
      description: Pre-defined filters for XIQ device type
      enum:
      - WIFI0
      - WIFI1
      - WIFI2
      example: WIFI0
    RmWiredQueueGridResponse:
      type: array
      description: QOS queue statistics per interface
      items:
        allOf:
        - type: array
        - $ref: '#/components/schemas/RmWiredPortQosState'
    XiqPage:
      required:
      - count
      - page
      - total_count
      - total_pages
      type: object
      properties:
        page:
          type: integer
          description: The current page number
          format: int32
        count:
          type: integer
          description: The element count of the current page
          format: int32
        total_pages:
          type: integer
          description: The total page number based on request page size
          format: int32
        total_count:
          type: integer
          description: The total element count
          format: int64
    RmClientGraphResponse:
      type: object
      description: The response for client graph.
      properties:
        timestamp:
          type: integer
          description: The graph metric timestamp.
          format: int64
        connected_clients:
          type: integer
          format: int64
          description: The channel utilization percentage.
        unique_clients:
          type: integer
          format: int64
          description: The number of clients connected.
        poor_health_clients:
          type: integer
          format: int64
          description: The signal-to-noise ratio.
    RmDeviceData:
      type: object
      description: The Device Data.
      properties:
        folder_id:
          type: integer
          format: int64
          description: Unique identifier for the folder containing the device.
        device_id:
          type: integer
          format: int64
          description: Unique identifier for the device.
        device_mac_address:
          type: string
          description: MAC address of the device.
        device_type:
          type: string
          description: Type or category of the device.
        device_function:
          type: string
          description: Function or role of the device.
        device_model:
          type: string
          description: The model of the device.
        host_name:
          type: string
          description: Hostname assigned to the device.
        image_base_url:
          type: string
          description: Base URL for the device's image.
        image_file_name:
          type: string
          description: File name of the device's image.
        image_width:
          type: integer
          description: Width of the device's image in pixels.
        image_height:
          type: integer
          description: Height of the device's image in pixels.
        connected_since:
          type: integer
          format: int64
          description: Timestamp indicating when the device was first connected.
        xaxis:
          type: integer
          description: X-axis coordinate of the device's location.
        yaxis:
          type: integer
          description: Y-axis coordinate of the device's location.
    PagedRmWiredQueueGridResponse:
      allOf:
      - $ref: '#/components/schemas/XiqPage'
      - type: object
        properties:
          data:
            type: array
            description: The data in the current page
            items:
              $ref: '#/components/schemas/RmWiredQueueGridResponse'
    RmWiredInterfaceGrid:
      type: array
      description: An array of wired interface objects.
      items:
        type: object
        properties:
          status:
            type: string
            enum:
            - online
            - offline
            - unknown
            description: The status of the interface.
          interface:
            type: string
            enum:
            - eth0
            - eth1
            description: The interface identifier.
          poe_usage:
            type: boolean
            description: Whether POE is being used
          port:
            type: string
            description: The port type.
          speed:
            type: integer
            description: The speed of the interface in Mbps.
          tx_bytes:
            type: integer
            description: The number of transmitted bytes.
          rx_bytes:
          

# --- truncated at 32 KB (54 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/extreme-networks/refs/heads/main/openapi/extreme-networks-d360-api-openapi.yml