Merge pull request #245 from cisco-en-programmability/develop

fix: update parameter types for limit and offset to int in multiple m…

Author: bvargasre

CHANGELOG.md

@@ -6,6 +6,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.11.2] - 2026-02-26
+### Fixed
+- **`limit` and `offset` parameter types (v2.3.7.9, v3.1.3.0)**: Changed `limit` and `offset` query parameters from `str` to `int` type in `check_type` validations and docstrings across multiple modules, matching the corrected types already applied in v3.1.6.0. Affected modules:
+  - `application_policy` (v2.3.7.9, v3.1.3.0)
+  - `devices` (v2.3.7.9, v3.1.3.0)
+  - `lan_automation` (v2.3.7.9, v3.1.3.0)
+  - `sda` (v2.3.7.9, v3.1.3.0)
+  - `sites` (v2.3.7.9, v3.1.3.0)
+  - `wireless` (v2.3.7.9, v3.1.3.0)
+- **Validator schema types (v2.3.7.9, v3.1.3.0)**: Fixed `limit` and `offset` JSON schema types from `"number"` to `"integer"` in `GetDeviceInterfaceStatsInfoV2` and `RogueAdditionalDetails` request validators.
+
 ## [2.11.1] - 2026-02-25
 ### Fixed
 - **Validator `required` fields (v3.1.6.0)**: Removed incorrectly added `required` blocks from v3.1.6.0 validators that were not present in the stable v3.1.3.0 baseline, preventing false validation failures on valid optional fields.
@@ -849,4 +860,5 @@ respond with a binary.
 [2.10.6]: https://github.com/cisco-en-programmability/dnacentersdk/compare/v2.10.5...v2.10.6
 [2.11.0]: https://github.com/cisco-en-programmability/dnacentersdk/compare/v2.10.6...v2.11.0
 [2.11.1]: https://github.com/cisco-en-programmability/dnacentersdk/compare/v2.11.0...v2.11.1
-[Unreleased]: https://github.com/cisco-en-programmability/dnacentersdk/compare/v2.11.1...develop
+[2.11.2]: https://github.com/cisco-en-programmability/dnacentersdk/compare/v2.11.1...v2.11.2
+[Unreleased]: https://github.com/cisco-en-programmability/dnacentersdk/compare/v2.11.2...develop

dnacentersdk/api/v2_3_7_9/application_policy.py

@@ -830,9 +830,9 @@ def retrieve_the_list_of_network_devices_with_their_application_visibility_statu
             application_registry_sync_status(str): applicationRegistrySyncStatus query parameter. Indicates whether
                 the latest definitions from application registry have been synchronized with the network
                 device or not. Available values: SYNCING, IN_SYNC, OUT_OF_SYNC, NOT_APPLICABLE .
-            offset(str): offset query parameter. The first record to show for this page; the first record is
+            offset(int): offset query parameter. The first record to show for this page; the first record is
                 numbered 1. Default value is: 1. .
-            limit(str): limit query parameter. The number of records to show for this page. Minimum value is: 1,
+            limit(int): limit query parameter. The number of records to show for this page. Minimum value is: 1,
                 Maximum value is: 500 .
             sort_by(str): sortBy query parameter. A property within the response to sort by. .
             order(str): order query parameter. Whether ascending or descending order should be used to sort the
@@ -865,8 +865,8 @@ def retrieve_the_list_of_network_devices_with_their_application_visibility_statu
         check_type(protocol_pack_status, str)
         check_type(protocol_pack_update_status, str)
         check_type(application_registry_sync_status, str)
-        check_type(offset, str)
-        check_type(limit, str)
+        check_type(offset, int)
+        check_type(limit, int)
         check_type(sort_by, str)
         check_type(order, str)
         if headers is not None:

dnacentersdk/api/v2_3_7_9/devices.py

@@ -11067,8 +11067,8 @@ def retrieve_scheduled_maintenance_windows_for_network_devices(
             network_device_ids(str): networkDeviceIds query parameter. List of network device ids. .
             status(str): status query parameter. The status of the maintenance schedule. Possible values are:
                 UPCOMING, IN_PROGRESS, COMPLETED, FAILED. Refer features for more details. .
-            limit(str): limit query parameter. The number of records to show for this page. Min: 1, Max: 500 .
-            offset(str): offset query parameter. The first record to show for this page; the first record is
+            limit(int): limit query parameter. The number of records to show for this page. Min: 1, Max: 500 .
+            offset(int): offset query parameter. The first record to show for this page; the first record is
                 numbered 1. .
             sort_by(str): sortBy query parameter. A property within the response to sort by. .
             order(str): order query parameter. Whether ascending or descending order should be used to sort the
@@ -11092,8 +11092,8 @@ def retrieve_scheduled_maintenance_windows_for_network_devices(
         check_type(headers, dict)
         check_type(network_device_ids, str)
         check_type(status, str)
-        check_type(limit, str)
-        check_type(offset, str)
+        check_type(limit, int)
+        check_type(offset, int)
         check_type(sort_by, str)
         check_type(order, str)
         if headers is not None:
@@ -11447,8 +11447,8 @@ def retrieve_network_devices(
                 provided, then it will default to BASIC views. If multiple views are provided, the
                 response will contain the union of the views. Refer features for more details. Available
                 values : BASIC, RESYNC, USER_DEFINED_FIELDS. .
-            limit(str): limit query parameter. The number of records to show for this page. Min: 1, Max: 500 .
-            offset(str): offset query parameter. The first record to show for this page; the first record is
+            limit(int): limit query parameter. The number of records to show for this page. Min: 1, Max: 500 .
+            offset(int): offset query parameter. The first record to show for this page; the first record is
                 numbered 1. .
             sort_by(str): sortBy query parameter. A property within the response to sort by. Available values : id,
                 managementAddress, dnsResolvedManagementIpAddress, hostname, macAddress, type, family,
@@ -11486,8 +11486,8 @@ def retrieve_network_devices(
         check_type(reachability_status, str)
         check_type(management_state, str)
         check_type(views, str)
-        check_type(limit, str)
-        check_type(offset, str)
+        check_type(limit, int)
+        check_type(offset, int)
         check_type(sort_by, str)
         check_type(order, str)
         if headers is not None:

dnacentersdk/api/v2_3_7_9/lan_automation.py

@@ -826,8 +826,8 @@ def get_port_channels(
             device2_management_ipaddress(str): device2ManagementIPAddress query parameter. The management IP address
                 of the device2. .
             device2_uuid(str): device2Uuid query parameter. Unique identifier for the network device2 .
-            offset(str): offset query parameter. Starting record for pagination. .
-            limit(str): limit query parameter. Maximum number of Port Channel to return. .
+            offset(int): offset query parameter. Starting record for pagination. .
+            limit(int): limit query parameter. Maximum number of Port Channel to return. .
             headers(dict): Dictionary of HTTP Headers to send with the Request
                 .
             **request_parameters: Additional request parameters (provides
@@ -849,8 +849,8 @@ def get_port_channels(
         check_type(device1_uuid, str)
         check_type(device2_management_ipaddress, str)
         check_type(device2_uuid, str)
-        check_type(offset, str)
-        check_type(limit, str)
+        check_type(offset, int)
+        check_type(limit, int)
         if headers is not None:
             if "X-Auth-Token" in headers:
                 check_type(headers.get("X-Auth-Token"), str, may_be_none=False)

dnacentersdk/api/v2_3_7_9/sda.py

@@ -10374,7 +10374,7 @@ def security_service_insertions(
         """Retrieves a list of all Security Service Insertions (SSIs) configured across fabric sites. .
 
         Args:
-            limit(str): limit query parameter. Maximum number of records to return. Default value is 100, minimum
+            limit(int): limit query parameter. Maximum number of records to return. Default value is 100, minimum
                 value is 1 and maximum value is 100. .
             offset(int): offset query parameter. Starting record for pagination. The first record is numbered 1. .
             order(str): order query parameter. The sorting order for the response can be specified as either
@@ -10398,7 +10398,7 @@ def security_service_insertions(
             https://developer.cisco.com/docs/dna-center/#!security-service-insertions
         """
         check_type(headers, dict)
-        check_type(limit, str)
+        check_type(limit, int)
         check_type(offset, int)
         check_type(order, str)
         check_type(fabric_site_name, str)

dnacentersdk/api/v2_3_7_9/sites.py

@@ -3608,8 +3608,8 @@ def get_devices_that_are_assigned_to_a_site(
 
         Args:
             id(str): id path parameter. Site Id .
-            offset(str): offset query parameter. Offset/starting index for pagination .
-            limit(str): limit query parameter. Number of devices to be listed. Default and max supported value is
+            offset(int): offset query parameter. Offset/starting index for pagination .
+            limit(int): limit query parameter. Number of devices to be listed. Default and max supported value is
                 500 .
             member_type(str): memberType query parameter. Member type (This API only supports the 'networkdevice'
                 type) .
@@ -3632,8 +3632,8 @@ def get_devices_that_are_assigned_to_a_site(
             https://developer.cisco.com/docs/dna-center/#!get-devices-that-are-assigned-to-a-site
         """
         check_type(headers, dict)
-        check_type(offset, str)
-        check_type(limit, str)
+        check_type(offset, int)
+        check_type(limit, int)
         check_type(member_type, str, may_be_none=False)
         check_type(level, str)
         check_type(id, str, may_be_none=False)
@@ -3887,8 +3887,8 @@ def get_site_v2(
                 .
             id(str): id query parameter. Site Id .
             type(str): type query parameter. Site type (Acceptable values: area, building, floor) .
-            offset(str): offset query parameter. Offset/starting index for pagination .
-            limit(str): limit query parameter. Number of sites to be listed. Default and max supported value is 500
+            offset(int): offset query parameter. Offset/starting index for pagination .
+            limit(int): limit query parameter. Number of sites to be listed. Default and max supported value is 500
                 .
             headers(dict): Dictionary of HTTP Headers to send with the Request
                 .
@@ -3910,8 +3910,8 @@ def get_site_v2(
         check_type(group_name_hierarchy, str)
         check_type(id, str)
         check_type(type, str)
-        check_type(offset, str)
-        check_type(limit, str)
+        check_type(offset, int)
+        check_type(limit, int)
         if headers is not None:
             if "X-Auth-Token" in headers:
                 check_type(headers.get("X-Auth-Token"), str, may_be_none=False)

dnacentersdk/api/v2_3_7_9/wireless.py

@@ -9993,9 +9993,9 @@ def get_anchor_groups(
         """This API allows the user to get AnchorGroups that captured in wireless settings design. .
 
         Args:
-            limit(str): limit query parameter. The number of records to show for this page. Default is 500 if not
+            limit(int): limit query parameter. The number of records to show for this page. Default is 500 if not
                 specified. Maximum allowed limit is 500. .
-            offset(str): offset query parameter. The first record to show for this page, the first record is
+            offset(int): offset query parameter. The first record to show for this page, the first record is
                 numbered 1. .
             headers(dict): Dictionary of HTTP Headers to send with the Request
                 .
@@ -10014,8 +10014,8 @@ def get_anchor_groups(
             https://developer.cisco.com/docs/dna-center/#!get-anchor-groups
         """
         check_type(headers, dict)
-        check_type(limit, str)
-        check_type(offset, str)
+        check_type(limit, int)
+        check_type(offset, int)
         if headers is not None:
             if "X-Auth-Token" in headers:
                 check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
@@ -10304,9 +10304,9 @@ def get_ap_authorization_lists(
             ap_authorization_list_name(str): apAuthorizationListName query parameter. Employ this query parameter to
                 obtain the details of the AP Authorization List corresponding to the provided
                 apAuthorizationListName. .
-            offset(str): offset query parameter. The first record to show for this page. The first record is
+            offset(int): offset query parameter. The first record to show for this page. The first record is
                 numbered 1. .
-            limit(str): limit query parameter. The number of records to show for this page. Default is 500 if not
+            limit(int): limit query parameter. The number of records to show for this page. Default is 500 if not
                 specified. Maximum allowed limit is 500. .
             headers(dict): Dictionary of HTTP Headers to send with the Request
                 .
@@ -10326,8 +10326,8 @@ def get_ap_authorization_lists(
         """
         check_type(headers, dict)
         check_type(ap_authorization_list_name, str)
-        check_type(offset, str)
-        check_type(limit, str)
+        check_type(offset, int)
+        check_type(limit, int)
         if headers is not None:
             if "X-Auth-Token" in headers:
                 check_type(headers.get("X-Auth-Token"), str, may_be_none=False)
@@ -10845,9 +10845,9 @@ def get_ap_profiles(
         """This API allows the user to get AP Profiles that captured in wireless settings design. .
 
         Args:
-            limit(str): limit query parameter. The number of records to show for this page. Default is 500 if not
+            limit(int): limit query parameter. The number of records to show for this page. Default is 500 if not
                 specified. Maximum allowed limit is 500. .
-            offset(str): offset query parameter. The first record to show for this page, the first record is
+            offset(int): offset query parameter. The first record to show for this page, the first record is
                 numbered 1. .
             ap_profile_name(str): apProfileName query parameter. Employ this query parameter to obtain the details
                 of the apProfiles corresponding to the provided apProfileName. .
@@ -10868,8 +10868,8 @@ def get_ap_profiles(
             https://developer.cisco.com/docs/dna-center/#!get-a-p-profiles
         """
         check_type(headers, dict)
-        check_type(limit, str)
-        check_type(offset, str)
+        check_type(limit, int)
+        check_type(offset, int)
         check_type(ap_profile_name, str)
         if headers is not None:
             if "X-Auth-Token" in headers:

dnacentersdk/api/v3_1_3_0/application_policy.py

@@ -830,9 +830,9 @@ def retrieve_the_list_of_network_devices_with_their_application_visibility_statu
             application_registry_sync_status(str): applicationRegistrySyncStatus query parameter. Indicates whether
                 the latest definitions from application registry have been synchronized with the network
                 device or not. Available values: SYNCING, IN_SYNC, OUT_OF_SYNC, NOT_APPLICABLE .
-            offset(str): offset query parameter. The first record to show for this page; the first record is
+            offset(int): offset query parameter. The first record to show for this page; the first record is
                 numbered 1. Default value is: 1. .
-            limit(str): limit query parameter. The number of records to show for this page. Minimum value is: 1,
+            limit(int): limit query parameter. The number of records to show for this page. Minimum value is: 1,
                 Maximum value is: 500 .
             sort_by(str): sortBy query parameter. A property within the response to sort by. .
             order(str): order query parameter. Whether ascending or descending order should be used to sort the
@@ -865,8 +865,8 @@ def retrieve_the_list_of_network_devices_with_their_application_visibility_statu
         check_type(protocol_pack_status, str)
         check_type(protocol_pack_update_status, str)
         check_type(application_registry_sync_status, str)
-        check_type(offset, str)
-        check_type(limit, str)
+        check_type(offset, int)
+        check_type(limit, int)
         check_type(sort_by, str)
         check_type(order, str)
         if headers is not None:

dnacentersdk/api/v3_1_3_0/devices.py

@@ -11067,8 +11067,8 @@ def retrieve_scheduled_maintenance_windows_for_network_devices(
             network_device_ids(str): networkDeviceIds query parameter. List of network device ids. .
             status(str): status query parameter. The status of the maintenance schedule. Possible values are:
                 UPCOMING, IN_PROGRESS, COMPLETED, FAILED. Refer features for more details. .
-            limit(str): limit query parameter. The number of records to show for this page. Min: 1, Max: 500 .
-            offset(str): offset query parameter. The first record to show for this page; the first record is
+            limit(int): limit query parameter. The number of records to show for this page. Min: 1, Max: 500 .
+            offset(int): offset query parameter. The first record to show for this page; the first record is
                 numbered 1. .
             sort_by(str): sortBy query parameter. A property within the response to sort by. .
             order(str): order query parameter. Whether ascending or descending order should be used to sort the
@@ -11092,8 +11092,8 @@ def retrieve_scheduled_maintenance_windows_for_network_devices(
         check_type(headers, dict)
         check_type(network_device_ids, str)
         check_type(status, str)
-        check_type(limit, str)
-        check_type(offset, str)
+        check_type(limit, int)
+        check_type(offset, int)
         check_type(sort_by, str)
         check_type(order, str)
         if headers is not None:
@@ -11447,8 +11447,8 @@ def retrieve_network_devices(
                 provided, then it will default to BASIC views. If multiple views are provided, the
                 response will contain the union of the views. Refer features for more details. Available
                 values : BASIC, RESYNC, USER_DEFINED_FIELDS. .
-            limit(str): limit query parameter. The number of records to show for this page. Min: 1, Max: 500 .
-            offset(str): offset query parameter. The first record to show for this page; the first record is
+            limit(int): limit query parameter. The number of records to show for this page. Min: 1, Max: 500 .
+            offset(int): offset query parameter. The first record to show for this page; the first record is
                 numbered 1. .
             sort_by(str): sortBy query parameter. A property within the response to sort by. Available values : id,
                 managementAddress, dnsResolvedManagementIpAddress, hostname, macAddress, type, family,
@@ -11486,8 +11486,8 @@ def retrieve_network_devices(
         check_type(reachability_status, str)
         check_type(management_state, str)
         check_type(views, str)
-        check_type(limit, str)
-        check_type(offset, str)
+        check_type(limit, int)
+        check_type(offset, int)
         check_type(sort_by, str)
         check_type(order, str)
         if headers is not None: