0.60.4

Author: tmunzer-AIDE

.gitmodules

@@ -1,4 +1,4 @@
 [submodule "mist_openapi"]
 	path = mist_openapi
 	url = https://github.com/mistsys/mist_openapi.git
-	branch = 2602.1.2
+	branch = 2602.1.5

CHANGELOG.md

@@ -1,4 +1,45 @@
 # CHANGELOG
+## Version 0.60.4 (March 2026)
+
+**Released**: March 3, 2026
+
+This release updates the OpenAPI submodule to version 2602.1.4, adds the new Map Stacks API, and includes various API improvements and bug fixes.
+
+---
+
+### 1. NEW FEATURES
+
+##### **Site Map Stacks API**
+- Added new `sites/mapstacks.py` module with `listSiteMapStacks()` and `createSiteMapStack()` functions
+
+---
+
+### 2. CHANGES
+
+##### **API Function Updates**
+- Updated `searchOrgInventory()` in `orgs/inventory.py`: Added `model` parameter for device model filtering
+- Updated `searchOrgJsiAssetsAndContracts()` in `orgs/jsi.py`:
+  - Replaced `eol_duration` and `eos_duration` with date-based filters: `eol_after`, `eol_before`, `eos_after`, `eos_before`
+  - Added `version_eos_after` and `version_eos_before` for software version end-of-support filtering
+  - Added `sirt_id` and `pbn_id` for security advisory filtering
+- Updated `searchOrgAlarms()` and `searchSiteAlarms()` documentation with Marvis alarm group details
+
+
+---
+
+### 3. BUG FIXES
+
+- Fixed `APIResponse.data` type annotation to support both `dict` and `list` responses
+- Fixed `_check_next()` method to properly handle list responses in pagination
+
+---
+
+### Breaking Changes
+
+- `searchOrgJsiAssetsAndContracts()`: Parameters `eol_duration` and `eos_duration` have been replaced with `eol_after`, `eol_before`, `eos_after`, and `eos_before`
+
+---
+
 ## Version 0.60.3 (February 2026)
 
 **Released**: February 21, 2026

mist_openapi

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "mistapi"
-version = "0.60.3"
+version = "0.60.4"
 authors = [{ name = "Thomas Munzer", email = "tmunzer@juniper.net" }]
 description = "Python package to simplify the Mist System APIs usage"
 keywords = ["Mist", "Juniper", "API"]

pyproject.toml

@@ -34,7 +34,7 @@ def __init__(
             URL of the HTTP Request
         """
         self.raw_data: str = ""
-        self.data: dict = {}
+        self.data: dict | list = {}
         self.url: str = url
         self.next: str | None = None
         self.headers: CaseInsensitiveDict[str] | None = None
@@ -67,7 +67,7 @@ def __init__(
 
     def _check_next(self) -> None:
         logger.debug("apiresponse:_check_next")
-        if "next" in self.data:
+        if isinstance(self.data, dict) and "next" in self.data:
             self.next = self.data["next"]
             logger.debug(f"apiresponse:_check_next:set next to {self.next}")
         elif self.headers:

src/mistapi/__api_response.py

@@ -1,2 +1,2 @@
-__version__ = "0.60.3"
+__version__ = "0.60.4"
 __author__ = "Thomas Munzer <tmunzer@juniper.net>"

src/mistapi/__version.py

@@ -144,38 +144,43 @@ def searchOrgAlarms(
     search_after: str | None = None,
 ) -> _APIResponse:
     """
-    API doc: https://www.juniper.net/documentation/us/en/software/mist/api/http/api/orgs/alarms/search-org-alarms
-
-    PARAMS
-    -----------
-    mistapi.APISession : mist_session
-        mistapi session including authentication and Mist host information
-
-    PATH PARAMS
-    -----------
-    org_id : str
-
-    QUERY PARAMS
-    ------------
-    site_id : str
-    group : str{'infrastructure', 'marvis', 'security'}
-      Alarm group. enum: `infrastructure`, `marvis`, `security`
-    severity : str{'critical', 'info', 'warn'}
-      Severity of the alarm. enum: `critical`, `info`, `warn`
-    type : str
-    ack_admin_name : str
-    acked : bool
-    start : str
-    end : str
-    duration : str, default: 1d
-    limit : int, default: 100
-    sort : str, default: timestamp
-    search_after : str
-
-    RETURN
-    -----------
-    mistapi.APIResponse
-        response from the API call
+        API doc: https://www.juniper.net/documentation/us/en/software/mist/api/http/api/orgs/alarms/search-org-alarms
+
+        PARAMS
+        -----------
+        mistapi.APISession : mist_session
+            mistapi session including authentication and Mist host information
+
+        PATH PARAMS
+        -----------
+        org_id : str
+
+        QUERY PARAMS
+        ------------
+        site_id : str
+        group : str{'infrastructure', 'marvis', 'security'}
+          Alarm group. enum: `infrastructure`, `marvis`, `security`.
+    The `marvis` group is used to retrieve AI-driven network issue detections.
+    Known Marvis alarm types include: `bad_cable`, `bad_wan_uplink`, `dns_failure`,
+    `arp_failure`, `auth_failure`, `dhcp_failure`, `missing_vlan`,
+    `negotiation_mismatch`, `port_flap`. Results include resolution status
+    (`status`, `resolved_time`) and affected entity details."
+        severity : str{'critical', 'info', 'warn'}
+          Severity of the alarm. enum: `critical`, `info`, `warn`
+        type : str
+        ack_admin_name : str
+        acked : bool
+        start : str
+        end : str
+        duration : str, default: 1d
+        limit : int, default: 100
+        sort : str, default: timestamp
+        search_after : str
+
+        RETURN
+        -----------
+        mistapi.APIResponse
+            response from the API call
     """
 
     uri = f"/api/v1/orgs/{org_id}/alarms/search"

src/mistapi/api/v1/orgs/alarms.py

@@ -260,7 +260,7 @@ def searchOrgDeviceEvents(
     ------------
     mac : str
     model : str
-    device_type : str{'all', 'ap', 'gateway', 'switch'}, default: ap
+    device_type : str, default: ap
     text : str
     timestamp : str
     type : str

src/mistapi/api/v1/orgs/devices.py

@@ -316,6 +316,7 @@ def searchOrgInventory(
     org_id: str,
     type: str | None = None,
     mac: str | None = None,
+    model: str | None = None,
     vc_mac: str | None = None,
     master_mac: str | None = None,
     site_id: str | None = None,
@@ -345,6 +346,7 @@ def searchOrgInventory(
     ------------
     type : str{'ap', 'gateway', 'switch'}, default: ap
     mac : str
+    model : str
     vc_mac : str
     master_mac : str
     site_id : str
@@ -370,6 +372,8 @@ def searchOrgInventory(
         query_params["type"] = str(type)
     if mac:
         query_params["mac"] = str(mac)
+    if model:
+        query_params["model"] = str(model)
     if vc_mac:
         query_params["vc_mac"] = str(vc_mac)
     if master_mac:

src/mistapi/api/v1/orgs/inventory.py

@@ -245,9 +245,15 @@ def searchOrgJsiAssetsAndContracts(
     sku: str | None = None,
     status: str | None = None,
     warranty_type: str | None = None,
-    eol_duration: str | None = None,
-    eos_duration: str | None = None,
+    eol_after: str | None = None,
+    eol_before: str | None = None,
+    eos_after: str | None = None,
+    eos_before: str | None = None,
+    version_eos_after: str | None = None,
+    version_eos_before: str | None = None,
     has_support: bool | None = None,
+    sirt_id: str | None = None,
+    pbn_id: str | None = None,
     text: str | None = None,
     limit: int | None = None,
     sort: str | None = None,
@@ -275,9 +281,15 @@ def searchOrgJsiAssetsAndContracts(
       Device status
     warranty_type : str{'Standard Hardware Warranty', 'Enhanced Hardware Warranty', 'Dead On Arrival Warranty', 'Limited Lifetime Warranty', 'Software Warranty', 'Limited Lifetime Warranty for WLA', 'Warranty-JCPO EOL (DOA Not Included)', 'MIST Enhanced Hardware Warranty', 'MIST Standard Warranty', 'Determine Lifetime warranty'}
       Device warranty type
-    eol_duration : str
-    eos_duration : str
+    eol_after : str
+    eol_before : str
+    eos_after : str
+    eos_before : str
+    version_eos_after : str
+    version_eos_before : str
     has_support : bool
+    sirt_id : str
+    pbn_id : str
     text : str
     limit : int, default: 100
     sort : str, default: timestamp
@@ -303,12 +315,24 @@ def searchOrgJsiAssetsAndContracts(
         query_params["status"] = str(status)
     if warranty_type:
         query_params["warranty_type"] = str(warranty_type)
-    if eol_duration:
-        query_params["eol_duration"] = str(eol_duration)
-    if eos_duration:
-        query_params["eos_duration"] = str(eos_duration)
+    if eol_after:
+        query_params["eol_after"] = str(eol_after)
+    if eol_before:
+        query_params["eol_before"] = str(eol_before)
+    if eos_after:
+        query_params["eos_after"] = str(eos_after)
+    if eos_before:
+        query_params["eos_before"] = str(eos_before)
+    if version_eos_after:
+        query_params["version_eos_after"] = str(version_eos_after)
+    if version_eos_before:
+        query_params["version_eos_before"] = str(version_eos_before)
     if has_support:
         query_params["has_support"] = str(has_support)
+    if sirt_id:
+        query_params["sirt_id"] = str(sirt_id)
+    if pbn_id:
+        query_params["pbn_id"] = str(pbn_id)
     if text:
         query_params["text"] = str(text)
     if limit: