zscaler-sdk-python 1.9.33__tar.gz → 1.9.35__tar.gz

{zscaler_sdk_python-1.9.33 → zscaler_sdk_python-1.9.35}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: zscaler-sdk-python
-Version: 1.9.33
+Version: 1.9.35
 Summary: Official Python SDK for the Zscaler Products
 Home-page: https://github.com/zscaler/zscaler-sdk-python
 License: MIT
@@ -96,6 +96,7 @@ used in your server-side code to interact with the Zscaler API platform across m
 * [Z-Insights - ZINS](https://help.zscaler.com/zscaler-analytics/getting-started) — GraphQL Analytics API
 * [ZMS - Zscaler Microsegmentation](https://help.zscaler.com/legacy-apis/using-zscaler-microsegmentation-api) — GraphQL Microsegmentation API
 * [Business Insights](https://automate.zscaler.com/docs/docs/api-reference-and-guides/api-reference/bi)
+* [Zscaler Cellular API (ZCell)](https://help.zscaler.com/)
 
 This SDK is designed to support the new Zscaler API framework [OneAPI](https://automate.zscaler.com/docs/getting-started/getting-started)
 via a single OAuth2 HTTP client. The SDK is also backwards compatible with the previous
@@ -273,6 +274,7 @@ In most cases, you won't need to build the SDK from source. If you want to build
 * [ZMS - Zscaler Microsegmentation](https://help.zscaler.com/legacy-apis/using-zscaler-microsegmentation-api) — GraphQL Microsegmentation API
 * [Zscaler AI Guard API](https://help.zscaler.com/ai-guard)
 * [Business Insights](https://automate.zscaler.com/docs/docs/api-reference-and-guides/api-reference/bi)
+* [Zscaler Cellular API (ZCell)](https://help.zscaler.com/)
 
 ## Usage guide
 
@@ -307,6 +309,7 @@ As of the publication of SDK version => 1.7.x, OneAPI is available for programma
 * [ZMS - Zscaler Microsegmentation](https://help.zscaler.com/legacy-apis/using-zscaler-microsegmentation-api) — GraphQL Microsegmentation API
 * [Zscaler AI Guard API](https://help.zscaler.com/ai-guard)
 * [Business Insights](https://automate.zscaler.com/docs/docs/api-reference-and-guides/api-reference/bi)
+* [Zscaler Cellular API (ZCell)](https://help.zscaler.com/)
 
 **NOTE** All other products such as Zscaler Cloud Connector (ZTW) and Zscaler Digital Experience (ZDX) are supported only via the legacy authentication method described in this README.
 
@@ -418,6 +421,56 @@ The authentication to Zscaler Private Access (ZPA) via the OneAPI framework, req
 | `vanityDomain`       | _(String)_ Refers to the domain name used by your organization `https://<vanity_domain>.zslogin.net/oauth2/v1/token` | `ZSCALER_VANITY_DOMAIN` |
 | `cloud`
 
+### Authenticating to Zscaler Cellular (ZCell)
+
+The authentication to Zscaler Cellular (ZCell) via the OneAPI framework uses the same Zidentity OAuth2 credentials (`clientId`, `clientSecret`/`privateKey`, `vanityDomain`, `cloud`) as the other products. ZCell API endpoints are scoped to a specific customer (`/customers/{id}`), so the SDK provides a dedicated `zcellCustomerId` attribute — and the `ZCELL_CUSTOMER_ID` environment variable — which is automatically injected into the request path. This value is completely independent from ZPA's `customerId`.
+
+You can supply the ZCell customer id in any of three ways (highest precedence first):
+
+1. Explicitly, as the `id` argument on any ZCell method call.
+2. Via the `zcellCustomerId` attribute in the client configuration.
+3. Via the `ZCELL_CUSTOMER_ID` environment variable.
+
+| Argument     | Description | Environment variable |
+|--------------|-------------|-------------------|
+| `clientId`       | _(String)_ Zscaler API Client ID, used with `clientSecret` or `privateKey` OAuth auth mode.| `ZSCALER_CLIENT_ID` |
+| `clientSecret`       | _(String)_ A string that contains the password for the API admin.| `ZSCALER_CLIENT_SECRET` |
+| `privateKey`       | _(String)_ A string Private key value.| `ZSCALER_PRIVATE_KEY` |
+| `vanityDomain`       | _(String)_ Refers to the domain name used by your organization `https://<vanity_domain>.zslogin.net/oauth2/v1/token` | `ZSCALER_VANITY_DOMAIN` |
+| `cloud`       | _(String)_ The host and basePath for the cloud services API is `$api.<cloud_name>.zsapi.net`.| `ZSCALER_CLOUD` |
+| `zcellCustomerId`       | _(String)_ The ZCell customer ID automatically scoped into the `/customers/{id}` request path. Independent from ZPA's `customerId`.| `ZCELL_CUSTOMER_ID` |
+
+Initialize the client with `zcellCustomerId` and call any ZCell service without repeating the customer id on every method:
+
+```py
+from zscaler import ZscalerClient
+
+config = {
+    "clientId": '{yourClientId}',
+    "clientSecret": '{yourClientSecret}',
+    "vanityDomain": '{yourvanityDomain}',
+    "cloud": "beta",                          # Optional when authenticating to an alternative cloud environment
+    "zcellCustomerId": "72058304855015424",   # ZCell customer id (independent from ZPA's customerId)
+    "logging": {"enabled": False, "verbose": False},
+}
+
+def main():
+    with ZscalerClient(config) as client:
+        # zcellCustomerId is injected automatically — no id argument needed
+        tags, resp, err = client.zcell.tag_handling.list_tag()
+        if err:
+            print(f"Error listing ZCell tags: {err}")
+            return
+        for tag in tags:
+            print(tag)
+
+        # You can still override the customer id explicitly per call
+        tags, resp, err = client.zcell.tag_handling.list_tag(id="another-customer-id")
+
+if __name__ == "__main__":
+    main()
+```
+
 ### Initialize OneAPI OAuth 2.0 Client
 
 #### OneAPI Client ID and Client Secret Authentication
@@ -665,7 +718,7 @@ The header `x-ratelimit-reset` is returned in the API response for each API call
 
 ## Pagination
 
-The pagination system in this SDK is unified across `ZCC`, `ZTW`, `ZDX`, `ZIA`, `ZPA`, `ZWA`
+The pagination system in this SDK is unified across `ZCC`, `ZTW`, `ZDX`, `ZIA`, `ZPA`, `ZWA`, `ZCell`
 and is applied transparently whether you're using the Legacy API Client or the new OneAPI OAuth2 Client.
 
 ✅ This means no code changes are needed when transitioning from the legacy API framework to OneAPI framework.
@@ -804,6 +857,7 @@ Each Zscaler service has its own pagination requirements and limits. The SDK aut
 | ZPA     | 20                    | 500           | Uses `page`, `pagesize`                         |
 | ZTW     | 100                   | Varies        | Uses `page`, `pageSize`                         |
 | ZWA     | Varies by endpoint    | Varies        | Uses `page`, `pageSize`                         |
+| ZCell   | 10                    | 100           | Uses `page` (0-based) + `pageSize`              |
 
 **Important Notes:**
 - ✅ The SDK automatically uses each API's default page size when no `page_size` is specified

{zscaler_sdk_python-1.9.33 → zscaler_sdk_python-1.9.35}/README.md

@@ -57,6 +57,7 @@ used in your server-side code to interact with the Zscaler API platform across m
 * [Z-Insights - ZINS](https://help.zscaler.com/zscaler-analytics/getting-started) — GraphQL Analytics API
 * [ZMS - Zscaler Microsegmentation](https://help.zscaler.com/legacy-apis/using-zscaler-microsegmentation-api) — GraphQL Microsegmentation API
 * [Business Insights](https://automate.zscaler.com/docs/docs/api-reference-and-guides/api-reference/bi)
+* [Zscaler Cellular API (ZCell)](https://help.zscaler.com/)
 
 This SDK is designed to support the new Zscaler API framework [OneAPI](https://automate.zscaler.com/docs/getting-started/getting-started)
 via a single OAuth2 HTTP client. The SDK is also backwards compatible with the previous
@@ -234,6 +235,7 @@ In most cases, you won't need to build the SDK from source. If you want to build
 * [ZMS - Zscaler Microsegmentation](https://help.zscaler.com/legacy-apis/using-zscaler-microsegmentation-api) — GraphQL Microsegmentation API
 * [Zscaler AI Guard API](https://help.zscaler.com/ai-guard)
 * [Business Insights](https://automate.zscaler.com/docs/docs/api-reference-and-guides/api-reference/bi)
+* [Zscaler Cellular API (ZCell)](https://help.zscaler.com/)
 
 ## Usage guide
 
@@ -268,6 +270,7 @@ As of the publication of SDK version => 1.7.x, OneAPI is available for programma
 * [ZMS - Zscaler Microsegmentation](https://help.zscaler.com/legacy-apis/using-zscaler-microsegmentation-api) — GraphQL Microsegmentation API
 * [Zscaler AI Guard API](https://help.zscaler.com/ai-guard)
 * [Business Insights](https://automate.zscaler.com/docs/docs/api-reference-and-guides/api-reference/bi)
+* [Zscaler Cellular API (ZCell)](https://help.zscaler.com/)
 
 **NOTE** All other products such as Zscaler Cloud Connector (ZTW) and Zscaler Digital Experience (ZDX) are supported only via the legacy authentication method described in this README.
 
@@ -379,6 +382,56 @@ The authentication to Zscaler Private Access (ZPA) via the OneAPI framework, req
 | `vanityDomain`       | _(String)_ Refers to the domain name used by your organization `https://<vanity_domain>.zslogin.net/oauth2/v1/token` | `ZSCALER_VANITY_DOMAIN` |
 | `cloud`
 
+### Authenticating to Zscaler Cellular (ZCell)
+
+The authentication to Zscaler Cellular (ZCell) via the OneAPI framework uses the same Zidentity OAuth2 credentials (`clientId`, `clientSecret`/`privateKey`, `vanityDomain`, `cloud`) as the other products. ZCell API endpoints are scoped to a specific customer (`/customers/{id}`), so the SDK provides a dedicated `zcellCustomerId` attribute — and the `ZCELL_CUSTOMER_ID` environment variable — which is automatically injected into the request path. This value is completely independent from ZPA's `customerId`.
+
+You can supply the ZCell customer id in any of three ways (highest precedence first):
+
+1. Explicitly, as the `id` argument on any ZCell method call.
+2. Via the `zcellCustomerId` attribute in the client configuration.
+3. Via the `ZCELL_CUSTOMER_ID` environment variable.
+
+| Argument     | Description | Environment variable |
+|--------------|-------------|-------------------|
+| `clientId`       | _(String)_ Zscaler API Client ID, used with `clientSecret` or `privateKey` OAuth auth mode.| `ZSCALER_CLIENT_ID` |
+| `clientSecret`       | _(String)_ A string that contains the password for the API admin.| `ZSCALER_CLIENT_SECRET` |
+| `privateKey`       | _(String)_ A string Private key value.| `ZSCALER_PRIVATE_KEY` |
+| `vanityDomain`       | _(String)_ Refers to the domain name used by your organization `https://<vanity_domain>.zslogin.net/oauth2/v1/token` | `ZSCALER_VANITY_DOMAIN` |
+| `cloud`       | _(String)_ The host and basePath for the cloud services API is `$api.<cloud_name>.zsapi.net`.| `ZSCALER_CLOUD` |
+| `zcellCustomerId`       | _(String)_ The ZCell customer ID automatically scoped into the `/customers/{id}` request path. Independent from ZPA's `customerId`.| `ZCELL_CUSTOMER_ID` |
+
+Initialize the client with `zcellCustomerId` and call any ZCell service without repeating the customer id on every method:
+
+```py
+from zscaler import ZscalerClient
+
+config = {
+    "clientId": '{yourClientId}',
+    "clientSecret": '{yourClientSecret}',
+    "vanityDomain": '{yourvanityDomain}',
+    "cloud": "beta",                          # Optional when authenticating to an alternative cloud environment
+    "zcellCustomerId": "72058304855015424",   # ZCell customer id (independent from ZPA's customerId)
+    "logging": {"enabled": False, "verbose": False},
+}
+
+def main():
+    with ZscalerClient(config) as client:
+        # zcellCustomerId is injected automatically — no id argument needed
+        tags, resp, err = client.zcell.tag_handling.list_tag()
+        if err:
+            print(f"Error listing ZCell tags: {err}")
+            return
+        for tag in tags:
+            print(tag)
+
+        # You can still override the customer id explicitly per call
+        tags, resp, err = client.zcell.tag_handling.list_tag(id="another-customer-id")
+
+if __name__ == "__main__":
+    main()
+```
+
 ### Initialize OneAPI OAuth 2.0 Client
 
 #### OneAPI Client ID and Client Secret Authentication
@@ -626,7 +679,7 @@ The header `x-ratelimit-reset` is returned in the API response for each API call
 
 ## Pagination
 
-The pagination system in this SDK is unified across `ZCC`, `ZTW`, `ZDX`, `ZIA`, `ZPA`, `ZWA`
+The pagination system in this SDK is unified across `ZCC`, `ZTW`, `ZDX`, `ZIA`, `ZPA`, `ZWA`, `ZCell`
 and is applied transparently whether you're using the Legacy API Client or the new OneAPI OAuth2 Client.
 
 ✅ This means no code changes are needed when transitioning from the legacy API framework to OneAPI framework.
@@ -765,6 +818,7 @@ Each Zscaler service has its own pagination requirements and limits. The SDK aut
 | ZPA     | 20                    | 500           | Uses `page`, `pagesize`                         |
 | ZTW     | 100                   | Varies        | Uses `page`, `pageSize`                         |
 | ZWA     | Varies by endpoint    | Varies        | Uses `page`, `pageSize`                         |
+| ZCell   | 10                    | 100           | Uses `page` (0-based) + `pageSize`              |
 
 **Important Notes:**
 - ✅ The SDK automatically uses each API's default page size when no `page_size` is specified

{zscaler_sdk_python-1.9.33 → zscaler_sdk_python-1.9.35}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "zscaler-sdk-python"
-version = "1.9.33"
+version = "1.9.35"
 description = "Official Python SDK for the Zscaler Products"
 authors = ["Zscaler, Inc. <devrel@zscaler.com>"]
 license = "MIT"

{zscaler_sdk_python-1.9.33 → zscaler_sdk_python-1.9.35}/zscaler/__init__.py

@@ -29,7 +29,7 @@ __license__ = "MIT"
 __contributors__ = [
     "William Guilherme",
 ]
-__version__ = "1.9.33"
+__version__ = "1.9.35"
 
 
 from zscaler.oneapi_client import Client as ZscalerClient  # noqa

{zscaler_sdk_python-1.9.33 → zscaler_sdk_python-1.9.35}/zscaler/config/config_setter.py

@@ -24,6 +24,7 @@ class ConfigSetter:
             "cloud": "",
             "userAgent": "",
             "customerId": "",
+            "zcellCustomerId": "",
             "microtenantId": "",
             "partnerId": "",
             "sandboxToken": "",

{zscaler_sdk_python-1.9.33 → zscaler_sdk_python-1.9.35}/zscaler/errors/zscaler_api_error.py

@@ -23,6 +23,8 @@ class ZscalerAPIError(Exception):
             or response_body.get("errorCode")
             # ZCC error envelope: {"title": "INVALID_FIELD_VALUE", "errorCode": null, ...}
             or response_body.get("title")
+            # ZCell error envelope: {"msgId": "invalid.access", ...}
+            or response_body.get("msgId")
         )
         self.error_message: Optional[str] = (
             response_body.get("message")
@@ -30,9 +32,13 @@ class ZscalerAPIError(Exception):
             or response_body.get("errorDetails")
             # ZCC error envelope: {"errorMessage": "Policy with policyId: ...", ...}
             or response_body.get("errorMessage")
+            # ZCell error envelope: {"detail": "Invalid Authentication.", ...}
+            or response_body.get("detail")
         )
         self.params: List[Any] = response_body.get("params", [])
         self.path: Optional[str] = response_body.get("path")
+        # ZCell error envelope carries an ISO-8601 timestamp.
+        self.timestamp: Optional[str] = response_body.get("timestamp")
 
         message_parts: List[str] = [f"HTTP {self.status_code}"]
         if self.error_code:
@@ -65,6 +71,8 @@ class ZscalerAPIError(Exception):
             error_payload["params"] = self.params
         if self.path:
             error_payload["path"] = self.path
+        if self.timestamp:
+            error_payload["timestamp"] = self.timestamp
         return json.dumps(error_payload, indent=2)
 
     def __repr__(self) -> str:

{zscaler_sdk_python-1.9.33 → zscaler_sdk_python-1.9.35}/zscaler/helpers.py

@@ -137,6 +137,12 @@ def to_snake_case(string):
         "locationDTO": "location_dto",
         "runtimeOS": "runtime_os",
         "defaultCSP": "default_csp",
+        # ZCell Edge Cases — all-caps telecom acronyms the generic heuristic
+        # would otherwise split letter-by-letter (e.g. "ECI" -> "e_c_i").
+        "ECI": "eci",
+        "MCC": "mcc",
+        "MNC": "mnc",
+        "TAC": "tac",
         # ZIdentity Edge Cases
         # "clientJWKsUrl": "clientJWKsUrl",
     }
@@ -285,6 +291,11 @@ def to_lower_camel_case(string):
         "location_dto": "locationDTO",
         "runtime_os": "runtimeOS",
         "default_csp": "defaultCSP",
+        # ZCell Edge Cases — all-caps telecom acronyms restored on the wire.
+        "eci": "ECI",
+        "mcc": "MCC",
+        "mnc": "MNC",
+        "tac": "TAC",
         # ZPA Timeout Policy: the API treats "reauth" as a single token. The
         # default heuristic would split "re_auth_*" into "reAuth*", which the
         # API rejects. Map both the "re_auth_*" and "reauth_*" spellings.

{zscaler_sdk_python-1.9.33 → zscaler_sdk_python-1.9.35}/zscaler/oneapi_client.py

@@ -16,6 +16,7 @@ from zscaler.zaiguard.zaiguard_service import ZGuardService
 from zscaler.zbi.zbi_service import ZBIService
 from zscaler.zcc.legacy import LegacyZCCClientHelper
 from zscaler.zcc.zcc_service import ZCCService
+from zscaler.zcell.zcell_service import ZCellService
 from zscaler.zdx.legacy import LegacyZDXClientHelper
 from zscaler.zdx.zdx_service import ZDXService
 from zscaler.zeasm.zeasm_service import ZEASMService
@@ -153,6 +154,10 @@ class Client:
         # Retrieve optional customerId from config or environment
         self._customer_id = self._config["client"].get("customerId", os.getenv("ZSCALER_CUSTOMER_ID"))
 
+        # Retrieve optional ZCell customer id from config or environment. This is
+        # ZCell-specific and completely independent from ZPA's customerId above.
+        self._zcell_customer_id = self._config["client"].get("zcellCustomerId") or os.getenv("ZCELL_CUSTOMER_ID")
+
         # Prune unnecessary configuration fields
         self._config = client_config_setter._prune_config(self._config)
         # Setup logging based on config
@@ -162,6 +167,10 @@ class Client:
         ConfigValidator(self._config)
         # self.logger.debug("Configuration validated successfully.")
 
+        # Ensure the resolved ZCell customer id (config or ZCELL_CUSTOMER_ID env)
+        # is available to ZCell service clients, which read it from the shared config.
+        self._config["client"]["zcellCustomerId"] = self._zcell_customer_id
+
         # Check inline configuration first, and if not provided, use environment variables
         self._client_id = self._config["client"].get("clientId", os.getenv("ZSCALER_CLIENT_ID"))
 
@@ -229,6 +238,7 @@ class Client:
         self._zms = None  # ZMS - Zscaler Microsegmentation (GraphQL API)
         self._zbi = None  # Zscaler Business Insights (REST API)
         self._zguard = None
+        self._zcell = None  # Zscaler Cellular (OneAPI only)
 
     def authenticate(self):
         """
@@ -268,6 +278,14 @@ class Client:
             self._zia = ZIAService(self._request_executor)
         return self._zia
 
+    @property
+    def zcell(self):
+        # ZCell is OneAPI-only (no legacy client); construct lazily with the
+        # RequestExecutor directly, matching ZIA/ZTW.
+        if self._zcell is None:
+            self._zcell = ZCellService(self._request_executor, self._config)
+        return self._zcell
+
     @property
     def zwa(self):
         if self.use_legacy_client:

{zscaler_sdk_python-1.9.33 → zscaler_sdk_python-1.9.35}/zscaler/oneapi_response.py

@@ -22,6 +22,7 @@ class ZscalerAPIResponse:
         "zpa": {"default": 100, "max": 500},
         "zia": {"default": 500, "max": 10000},
         "zdx": {"default": 10, "min": 1},
+        "zcell": {"default": 10, "max": 100, "min": 1},
     }
 
     def __init__(
@@ -86,8 +87,13 @@ class ZscalerAPIResponse:
             self._params.pop("page", None)
 
         # Resolve the user-supplied page size from the correct param key per service.
-        # ZIA uses "pageSize"; ZPA uses "pagesize"; others use "limit".
-        raw_page_size = self._params.get("pageSize") or self._params.get("pagesize") or self._params.get("limit")
+        # ZIA uses "pageSize"; ZPA uses "pagesize"; ZCell uses "size"; others use "limit".
+        raw_page_size = (
+            self._params.get("pageSize")
+            or self._params.get("pagesize")
+            or self._params.get("size")
+            or self._params.get("limit")
+        )
         self._limit = self.validate_page_size(raw_page_size, service_type)
 
         if res_details:
@@ -235,6 +241,21 @@ class ZscalerAPIResponse:
                         items = val
                         break
                 self._list = items
+        elif self._service_type == "zcell":
+            # ZCell wraps paginated list responses in a {"totalElements", "totalPages",
+            # "size", "content": [...]} envelope. Single-object responses (e.g. a
+            # GET-by-id or an activate) come back as a plain dict with no "content"
+            # key — treat those as a one-item list so get_results()/get_body() both work.
+            if isinstance(self._body, dict) and "content" in self._body and isinstance(self._body["content"], list):
+                self._list = self._body["content"]
+                self._total_pages = int(self._body.get("totalPages", 1))
+                self._total_count = int(self._body.get("totalElements", 0))
+            elif isinstance(self._body, dict):
+                self._list = [self._body]
+                self._is_flat_list_response = True
+            else:
+                self._list = self._body if isinstance(self._body, list) else []
+                self._is_flat_list_response = True
         else:
             # ZPA and possibly other services use a dict with "list" field
             self._list = self._body.get("list", [])
@@ -350,6 +371,13 @@ class ZscalerAPIResponse:
         if self._service_type == "zdx":
             logger.debug("[DEBUG] Taking ZDX pagination branch.")
             self._params["offset"] = self._next_offset
+        elif self._service_type == "zcell":
+            logger.debug("[DEBUG] Taking ZCell pagination branch.")
+            # ZCell pages are 0-based: the first (un-paginated) request returns
+            # page 0. The internal _page counter is 1-based, so the API page
+            # index is _page - 1 (e.g. _page == 2 -> page=1, the second page).
+            self._page += 1
+            self._params["page"] = self._page - 1
         elif self._service_type == "zia":
             logger.debug("[DEBUG] Taking ZIA pagination branch.")
             self._page += 1
@@ -399,9 +427,15 @@ class ZscalerAPIResponse:
             logger.debug("Has next page: False (flat list response - all results returned in single response)")
             return False
 
-        if self._service_type == "zpa":
+        if self._service_type in ("zpa", "zcell"):
             has_next = self._page < self._total_pages
-            logger.debug("Has next page for ZPA: %s (page %d of %d)", has_next, self._page, self._total_pages)
+            logger.debug(
+                "Has next page for %s: %s (page %d of %d)",
+                self._service_type.upper(),
+                has_next,
+                self._page,
+                self._total_pages,
+            )
             return has_next
         elif self._service_type == "zdx":
             has_next = self._next_offset is not None

{zscaler_sdk_python-1.9.33 → zscaler_sdk_python-1.9.35}/zscaler/request_executor.py

@@ -198,6 +198,8 @@ class RequestExecutor:
             return "zia"
         elif "/ztw" in url:
             return "ztw"
+        elif "/zcell/config/api/v1" in url:
+            return "zcell"
         elif "/zcc" in url:
             return "zcc"
         elif "/zdx" in url:
@@ -229,6 +231,8 @@ class RequestExecutor:
                 return "zia"
             elif "/ztw" in url:
                 return "ztw"
+            elif "/zcell/config/api/v1" in url:
+                return "zcell"
             elif "/zcc" in url:
                 return "zcc"
             elif "/zdx" in url:
@@ -242,7 +246,21 @@ class RequestExecutor:
         raise ValueError(f"Unsupported service: {url}")
 
     def remove_oneapi_endpoint_prefix(self, endpoint: str) -> str:
-        prefixes = ["admin", "/zia", "/zpa", "/zcc", "/ztw", "/zdx", "/zwa", "/zins", "/zms", "/ztb", "/bi", "/ziam"]
+        prefixes = [
+            "admin",
+            "/zia",
+            "/zpa",
+            "/zcc",
+            "/ztw",
+            "/zdx",
+            "/zwa",
+            "/zins",
+            "/zms",
+            "/ztb",
+            "/bi",
+            "/ziam",
+            "/zcell/config/api/v1",
+        ]
         for prefix in prefixes:
             if endpoint.startswith(prefix):
                 return endpoint[len(prefix) :]

{zscaler_sdk_python-1.9.33 → zscaler_sdk_python-1.9.35}/zscaler/utils.py

@@ -89,6 +89,8 @@ reformat_params = [
     ("criteria_domain_profile_ids", "criteriaDomainProfiles"),
     ("email_recipient_profile_ids", "emailRecipientProfiles"),
     ("entity_group_ids", "entityGroups"),
+    ("http_header_action_profile_ids", "httpHeaderActionProfiles"),
+    ("http_header_profile_ids", "httpHeaderProfiles"),
     ("scope_entity_ids", "adminScopeScopeEntities"),
     ("supported_region_ids", "supportedRegions"),
     ("src_workload_groups_ids", "srcWorkloadGroups"),
@@ -98,6 +100,7 @@ reformat_params = [
     ("connector_ids", "connectors"),
     ("server_group_ids", "serverGroups"),
     ("user_portal_ids", "userPortals"),
+    
 ]
 
 
@@ -479,6 +482,82 @@ def zdx_params(func):
     return wrapper
 
 
+def zcell_params(func=None, *, start_key="startDateTime", end_key="endDateTime", target="query"):
+    """
+    Decorator for ZCell endpoints that take an epoch-seconds time window. Lets
+    callers pass a single ``days`` shorthand instead of computing epoch
+    timestamps by hand (mirrors ZDX's ``since`` convenience):
+
+        client.zcell.anomaly_policy.list_anomaly_policy(id=cid, days=7)
+
+    becomes ``startDateTime = now - 7*86400`` and ``endDateTime = now`` (epoch
+    seconds). Explicit window params (or ``days`` omitted) are always respected
+    and never overwritten. ``days`` may be supplied either as a direct keyword
+    argument or inside ``query_params``.
+
+    Different ZCell endpoints name the window differently. Most use
+    ``startDateTime`` / ``endDateTime`` (the default), but some — e.g.
+    ``/sim/analytics/usage/countries`` — use ``startDate`` / ``endDate``. Pass
+    ``start_key`` / ``end_key`` to target those::
+
+        @zcell_params(start_key="startDate", end_key="endDate")
+        def list_sim_analytics_usage_countries(self, id, ...): ...
+
+    Some endpoints expect the window in the JSON request **body** rather than the
+    query string (e.g. the POST ``/audit/customers/{id}/search`` filter). Pass
+    ``target="body"`` to inject the derived window into the body kwargs instead::
+
+        @zcell_params(start_key="startDate", end_key="endDate", target="body")
+        def list_audit_customers_search(self, id, ..., **kwargs): ...
+
+    Other endpoints carry the window as URL **path** parameters (e.g. the POST
+    ``/network-events/{id}/search/startTime/{startTime}/endTime/{endTime}``). Pass
+    ``target="path"`` with ``start_key`` / ``end_key`` set to the function's own
+    parameter names so the shorthand fills those arguments::
+
+        @zcell_params(start_key="start_time", end_key="end_time", target="path")
+        def list_network_events_search(self, id, start_time=None, end_time=None, **kwargs): ...
+    """
+
+    def decorator(func):
+        @functools.wraps(func)
+        def wrapper(self, *args, **kwargs):
+            days = kwargs.pop("days", None)
+
+            if target in ("body", "path"):
+                # Window fields belong in the JSON request body or the URL path;
+                # both are passed through **kwargs (path values bind to the
+                # function's explicit parameters). setdefault so an explicit
+                # value wins over the shorthand.
+                if days is not None:
+                    now = int(time.time())
+                    kwargs.setdefault(start_key, now - int(days) * 86400)
+                    kwargs.setdefault(end_key, now)
+                return func(self, *args, **kwargs)
+
+            query_params = kwargs.get("query_params") or {}
+            if days is None:
+                days = query_params.pop("days", None)
+
+            if days is not None:
+                now = int(time.time())
+                # setdefault so an explicit window param wins over the shorthand
+                query_params.setdefault(start_key, now - int(days) * 86400)
+                query_params.setdefault(end_key, now)
+
+            if query_params:
+                kwargs["query_params"] = query_params
+
+            return func(self, *args, **kwargs)
+
+        return wrapper
+
+    # Support both bare (@zcell_params) and parameterized (@zcell_params(...)) usage.
+    if func is not None:
+        return decorator(func)
+    return decorator
+
+
 class CommonFilters:
     def __init__(self, **kwargs):
         valid_params = {