0.63.0 (#28)

Author: tmunzer-AIDE

CHANGELOG.md

@@ -1,4 +1,50 @@
 # CHANGELOG
+## Version 0.63.0 (June 2026)
+
+**Released**: June 12, 2026
+
+This release updates generated API bindings from the latest OpenAPI spec, adding new async claim, Marvis client, Marvis configuration, and AP localization workflows while expanding parameter documentation across the SDK.
+
+---
+
+### 1. NEW FEATURES
+
+#### **Org Async Claim APIs**
+Added a new org claims module for asynchronous claim workflows:
+- **`listOrgAsyncClaims()`**
+- **`createOrgAsyncClaim()`**
+- **`getOrgAsyncClaimStatus()`**
+
+#### **Org Marvis Client APIs**
+Added org-level Marvis client insight, event, and statistics operations:
+- **`getOrgMarvisClientInsights()`**
+- **`countOrgMarvisClientEvents()`**, **`searchOrgMarvisClientEvents()`**
+- **`countOrgMarvisClientsStats()`**, **`searchOrgMarvisClientsStats()`**
+
+#### **Site Marvis Configuration Actions**
+Added a new site Marvis configuration module with action search, count, delete, and feedback operations:
+- **`countSiteMarvisConfigActions()`**
+- **`searchSiteMarvisConfigActions()`**
+- **`deleteSiteMarvisConfigAction()`**
+- **`submitSiteMarvisConfigFeedback()`**
+
+#### **AP Localization Data Acceptance**
+Added a site maps operation for accepting AP localization data:
+- **`acceptSiteApLocalizationData()`**
+
+---
+
+### 2. IMPROVEMENTS
+
+#### **Expanded Query Parameter Coverage**
+Added and refined filters across generated endpoints, including device, client, stats, SLE, alarm, event, VPN, tunnel, NAC, webhook, PSK, and inventory APIs. New coverage includes richer `distinct` count fields, device type and status filters, duration ranges, pagination cursors, sort parameters, and model, hostname, MAC, OS, LLDP, RF, and Mist Edge filters.
+
+#### **Improved Generated Parameter Documentation**
+Updated the OpenAPI generator to preserve parameter descriptions, improving generated docstrings for wildcard matching, comma-separated values, enum meanings, pagination behavior, and conditional filters.
+
+
+---
+
 ## Version 0.62.0 (May 2026)
 
 **Released**: May 1, 2026

mist_openapi

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

pyproject.toml

@@ -206,6 +206,7 @@ def gen_param(data: dict, openapi_schemas: dict) -> dict:
             # Handle inline parameter definition - extract directly from schema
             tmp = {
                 "name": data["name"].replace(" ", "_").replace("-", "_"),
+                "description": data.get("description"),
                 "required": data.get("required", False),
                 "enum": data["schema"].get("enum", None),
                 "type": data["schema"].get("type"),

scripts/generate_from_openapi.py

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

src/mistapi/__version.py

@@ -28,6 +28,7 @@ def listApChannels(
     QUERY PARAMS
     ------------
     country_code : str
+      Country code, in two-character
 
     RETURN
     -----------

src/mistapi/api/v1/const/ap_channels.py

@@ -28,6 +28,7 @@ def listCountryCodes(
     QUERY PARAMS
     ------------
     extend : bool
+      Will include more country codes if true
 
     RETURN
     -----------

src/mistapi/api/v1/const/countries.py

@@ -28,7 +28,9 @@ def getGatewayDefaultConfig(
     QUERY PARAMS
     ------------
     model : str
+      Device model for which to generate the default gateway config.
     ha : str
+      Whether the config is intended for HA
 
     RETURN
     -----------

src/mistapi/api/v1/const/default_gateway_config.py

@@ -26,6 +26,7 @@ def listStates(mist_session: _APISession, country_code: str) -> _APIResponse:
     QUERY PARAMS
     ------------
     country_code : str
+      Country code, in [two-character](/#operations/listCountryCodes)
 
     RETURN
     -----------

src/mistapi/api/v1/const/states.py

@@ -32,6 +32,7 @@ def listInstallerDeviceProfiles(
     QUERY PARAMS
     ------------
     type : str{'ap', 'gateway', 'switch'}, default: ap
+      Filter results by type. enum: `ap`, `gateway`, `switch`
 
     RETURN
     -----------