zscaler-sdk-python 1.0.0__py2.py3-none-any.whl

zscaler/zia/url_filtering.py

@@ -0,0 +1,310 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2023, Zscaler Inc.
+#
+# Permission to use, copy, modify, and/or distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+
+from box import Box, BoxList
+from requests import Response
+
+from zscaler.utils import (
+    convert_keys,
+    recursive_snake_to_camel,
+    snake_to_camel,
+    transform_common_id_fields,
+)
+from zscaler.zia import ZIAClient
+
+
+class URLFilteringAPI:
+    # URL Filtering Policy rule keys that only require an ID to be provided.
+    reformat_params = [
+        ("departments", "departments"),
+        ("devices", "devices"),
+        ("device_groups", "deviceGroups"),
+        ("groups", "groups"),
+        ("labels", "labels"),
+        ("locations", "locations"),
+        ("location_groups", "locationGroups"),
+        ("override_users", "overrideUsers"),
+        ("override_groups", "overrideGroups"),
+        ("time_windows", "timeWindows"),
+        ("users", "users"),
+    ]
+
+    def __init__(self, client: ZIAClient):
+        self.rest = client
+
+    def list_rules(self) -> BoxList:
+        """
+        Returns the list of URL Filtering Policy rules
+
+        Returns:
+            :obj:`BoxList`: The list of URL Filtering Policy rules.
+
+        Examples:
+            >>> for rule in zia.url_filters.list_rules():
+            ...    pprint(rule)
+
+        """
+        response = self.rest.get("urlFilteringRules")
+        if isinstance(response, Response):
+            return None
+        return response
+
+    def get_rule(self, rule_id: str) -> Box:
+        """
+        Returns information on the specified URL Filtering Policy rule.
+
+        Args:
+            rule_id (str): The unique ID for the URL Filtering Policy rule.
+
+        Returns:
+            :obj:`Box`: The URL Filtering Policy rule.
+
+        Examples:
+            >>> pprint(zia.url_filters.get_rule('977469'))
+
+        """
+
+        return self.rest.get(f"urlFilteringRules/{rule_id}")
+
+    def add_rule(
+        self,
+        rank: str,
+        name: str,
+        action: str,
+        protocols: list,
+        # override_users: list,
+        # override_groups: list,
+        **kwargs,
+    ) -> Box:
+        """
+        Adds a new URL Filtering Policy rule.
+
+        Args:
+            rank (str): The admin rank of the user who creates the rule.
+            name (str): The name of the rule.
+            action (str): Action taken when traffic matches rule criteria. Accepted values are:
+
+                `ANY`, `NONE`, `BLOCK`, `CAUTION`, `ALLOW` and `ICAP_RESPONSE`
+
+            device_trust_levels (list): List of device trust levels for which the rule must be applied. Accepted values are:
+                `ANY`, `UNKNOWN_DEVICETRUSTLEVEL`, `LOW_TRUST`, `MEDIUM_TRUST`, and `HIGH_TRUST`
+
+            protocols (list): The protocol criteria for the rule.
+            **kwargs: Optional keyword args.
+
+        Keyword Args:
+            block_override (bool): When set to true, a 'BLOCK' action triggered by the rule could be overridden.
+                Defaults to `False`.
+            ciparule (bool): The CIPA compliance rule is enabled if this is set to `True`. Defaults to `False`.
+            departments (list): The IDs for the departments that this rule applies to.
+            devices (list): The IDs for the devices that this rule applies to.
+            device_groups (list): The IDs for the device groups that this rule applies to.
+            labels (list): The IDs for the labels that this rule applies to.
+            description (str): Additional information about the URL Filtering rule.
+            end_user_notification_url (str): URL of end user notification page to be displayed when the rule is matched.
+                Not applicable if either ``override_users`` or ``override_groups`` is specified.
+            enforce_time_validity (bool): Enforce a set validity time period for the URL Filtering rule.
+            groups (list): The IDs for the groups that this rule applies to.
+            locations (list): The IDs for the locations that this rule applies to.
+            location_groups (list): The IDs for the location groups that this rule applies to.
+            order (str): Order of execution of rule with respect to other URL Filtering rules. Defaults to placing rule
+                at the bottom of the list.
+            override_users (:obj:`list` of :obj:`int`): The IDs of users that this rule can be overridden for.
+                Only applies if ``block_override`` is True, ``action`` is `BLOCK` and ``override_groups`` is not set.
+            override_groups (:obj:`list` of :obj:`int`): The IDs of groups that this rule can be overridden for.
+                Only applies if ``block_override`` is True and ``action`` is `BLOCK`.
+            request_methods (list): The request methods that this rule will apply to. If not specified, the rule will
+                apply to all methods.
+            size_quota (str): Size quota in KB for applying the URL Filtering rule.
+            time_quota (str): Time quota in minutes elapsed after the URL Filtering rule is applied.
+            time_windows (list): The IDs for the time windows that this rule applies to.
+            url_categories (list): The names of URL categories that this rule applies to.
+            users (list): The IDs for the users that this rule applies to.
+            validity_start_time (str): Date and time the rule's effects will be valid from. ``enforce_time_validity``
+                must be set to `True` for this to take effect.
+            validity_end_time (str): Date and time the rule's effects will end. ``enforce_time_validity`` must be set to
+                `True` for this to take effect.
+            validity_time_zone_id (str): The URL Filter rule validity date and time will be based on the TZ provided.
+                ``enforce_time_validity`` must be set to `True` for this to take effect.
+
+        Returns:
+            :obj:`Box`: The newly created URL Filtering Policy rule.
+
+        Examples:
+            Add a rule with the minimum required parameters:
+
+            >>> zia.url_filters.add_rule(rank='7',
+            ...    name="Empty URL Filter",
+            ...    action="ALLOW",
+            ...    protocols=['ANY_RULE']
+
+            Add a rule to block HTTP POST to Social Media sites for the Finance department.
+
+            >>> zia.url_filters.add_rule(rank='7',
+            ...    name="Block POST to Social Media",
+            ...    action="BLOCK",
+            ...    protocols=["HTTP_PROXY", "HTTP_RULE", "HTTPS_RULE"],
+            ...    request_methods=['POST'],
+            ...    departments=["95022175"],
+            ...    url_categories=["SOCIAL_NETWORKING"])
+
+        """
+        # Convert enabled to API format if present
+        if "enabled" in kwargs:
+            kwargs["state"] = "ENABLED" if kwargs.pop("enabled") else "DISABLED"
+
+        # Initialize the payload with required parameters
+        payload = {
+            "rank": rank,
+            "name": name,
+            "action": action,
+            "protocols": protocols,
+            "order": kwargs.pop("order", len(self.list_rules())),
+        }
+
+        # Transform ID fields in kwargs
+        transform_common_id_fields(self.reformat_params, kwargs, payload)
+        for key, value in kwargs.items():
+            if value is not None:
+                payload[snake_to_camel(key)] = value
+
+        # Convert the entire payload's keys to camelCase before sending
+        camel_payload = recursive_snake_to_camel(payload)
+        for key, value in kwargs.items():
+            if value is not None:
+                camel_payload[snake_to_camel(key)] = value
+
+        # Send POST request to create the rule
+        response = self.rest.post("urlFilteringRules", json=payload)
+        if isinstance(response, Response):
+            # Handle error response
+            status_code = response.status_code
+            if status_code != 200:
+                raise Exception(
+                    f"API call failed with status {status_code}: {response.json()}"
+                )
+        return response
+
+    def update_rule(self, rule_id: str, **kwargs) -> Box:
+        """
+        Updates the specified URL Filtering Policy rule.
+
+        Args:
+            rule_id: The unique ID of the URL Filtering Policy rule to be updated.
+            **kwargs: Optional keyword args.
+
+        Keyword Args:
+            name (str): The name of the rule.
+            action (str): Action taken when traffic matches rule criteria. Accepted values are:
+
+                `ANY`, `NONE`, `BLOCK`, `CAUTION`, `ALLOW` and `ICAP_RESPONSE`
+
+            device_trust_levels (list): List of device trust levels for which the rule must be applied. Accepted values are:
+                `ANY`, `UNKNOWN_DEVICETRUSTLEVEL`, `LOW_TRUST`, `MEDIUM_TRUST`, and `HIGH_TRUST`
+
+            protocols (list): The protocol criteria for the rule.
+            block_override (bool): When set to true, a 'BLOCK' action triggered by the rule could be overridden.
+                Defaults to `False`.
+            ciparule (bool): The CIPA compliance rule is enabled if this is set to `True`. Defaults to `False`.
+            departments (list): The IDs for the departments that this rule applies to.
+            devices (list): The IDs for the devices that this rule applies to.
+            device_groups (list): The IDs for the device groups that this rule applies to.
+            labels (list): The IDs for the labels that this rule applies to.
+            description (str): Additional information about the URL Filtering rule.
+            end_user_notification_url (str): URL of end user notification page to be displayed when the rule is matched.
+                Not applicable if either ``override_users`` or ``override_groups`` is specified.
+            enforce_time_validity (bool): Enforce a set validity time period for the URL Filtering rule.
+            groups (list): The IDs for the groups that this rule applies to.
+            locations (list): The IDs for the locations that this rule applies to.
+            location_groups (list): The IDs for the location groups that this rule applies to.
+            order (str): Order of execution of rule with respect to other URL Filtering rules. Defaults to placing rule
+                at the bottom of the list.
+            override_users (:obj:`list` of :obj:`int`):
+                The IDs of users that this rule can be overridden for.
+                Only applies if ``block_override`` is True, ``action`` is `BLOCK` and ``override_groups`` is not set.
+            override_groups (:obj:`list` of :obj:`int`):
+                The IDs of groups that this rule can be overridden for.
+                Only applies if ``block_override`` is True and ``action`` is `BLOCK`.
+            request_methods (list): The request methods that this rule will apply to. If not specified, the rule will
+                apply to all methods.
+            size_quota (str): Size quota in KB for applying the URL Filtering rule.
+            time_quota (str): Time quota in minutes elapsed after the URL Filtering rule is applied.
+            time_windows (list): The IDs for the time windows that this rule applies to.
+            url_categories (list): The names of URL categories that this rule applies to.
+            users (list): The IDs for the users that this rule applies to.
+            validity_start_time (str): Date and time the rule's effects will be valid from. ``enforce_time_validity``
+                must be set to `True` for this to take effect.
+            validity_end_time (str): Date and time the rule's effects will end. ``enforce_time_validity`` must be set to
+                `True` for this to take effect.
+            validity_time_zone_id (str): The URL Filter rule validity date and time will be based on the TZ provided.
+                ``enforce_time_validity`` must be set to `True` for this to take effect.
+
+        Returns:
+            :obj:`Box`: The updated URL Filtering Policy rule.
+
+        Examples:
+            Update the name of a URL Filtering Policy rule:
+
+            >>> zia.url_filters.update_rule('977467',
+            ...    name="Updated Name")
+
+            Add GET to request methods and change action to ALLOW:
+
+            >>> zia.url_filters.update_rule('977468',
+            ...    request_methods=['POST', 'GET'],
+            ...    action="ALLOW")
+
+        """
+        # Set payload to value of existing record and convert nested dict keys.
+        payload = convert_keys(self.get_rule(rule_id))
+
+        # Convert enabled to API format if present in kwargs
+        if "enabled" in kwargs:
+            kwargs["state"] = "ENABLED" if kwargs.pop("enabled") else "DISABLED"
+
+        # Transform ID fields in kwargs
+        transform_common_id_fields(self.reformat_params, kwargs, payload)
+
+        # Add remaining optional parameters to payload
+        for key, value in kwargs.items():
+            payload[snake_to_camel(key)] = value
+
+        response = self.rest.put(f"urlFilteringRules/{rule_id}", json=payload)
+        if isinstance(response, Response) and not response.ok:
+            # Handle error response
+            raise Exception(
+                f"API call failed with status {response.status_code}: {response.json()}"
+            )
+
+        # Return the updated object
+        return self.get_rule(rule_id)
+
+    def delete_rule(self, rule_id: str) -> int:
+        """
+        Deletes the specified URL Filtering Policy rule.
+
+        Args:
+            rule_id (str): The unique ID for the URL Filtering Policy rule.
+
+        Returns:
+            :obj:`int`: The status code for the operation.
+
+        Examples:
+            >>> zia.url_filters.delete_rule('977463')
+
+        """
+        return self.rest.delete(f"urlFilteringRules/{rule_id}").status_code

zscaler/zia/users.py

@@ -0,0 +1,386 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2023, Zscaler Inc.
+#
+# Permission to use, copy, modify, and/or distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+
+from box import Box, BoxList
+
+from zscaler.utils import Iterator, convert_keys, snake_to_camel
+from zscaler.zia import ZIAClient
+
+
+class UserManagementAPI:
+    """
+    The methods within this section use the ZIA User Management API and are accessed via ``ZIA.users``.
+
+    """
+
+    def __init__(self, client: ZIAClient):
+        self.rest = client
+
+    def list_departments(self, **kwargs) -> BoxList:
+        """
+        Returns the list of departments.
+
+        Keyword Args:
+            **limit_search (bool, optional):
+                Limits the search to match against the department name only.
+            **max_items (int, optional):
+                The maximum number of items to request before stopping iteration.
+            **max_pages (int, optional):
+                The maximum number of pages to request before stopping iteration.
+            **page_size (int, optional):
+                Specifies the page size. The default size is 100, but the maximum size is 1000.
+            **search (str, optional):
+                The search string used to match against a department's name or comments attributes.
+            **sort_by (str):
+                The field name to sort by, supported values: id, name, creationTime or modifiedTime (default to name)
+            **sort_order (str):
+                The sort order, values: ASC or DESC (default DESC)
+
+        Returns:
+            :obj:`BoxList`: The list of departments configured in ZIA.
+
+        Examples:
+            List departments using default settings:
+
+            >>> for department in zia.users.list_departments():
+            ...   print(department)
+
+            List departments, limiting to a maximum of 10 items:
+
+            >>> for department in zia.users.list_departments(max_items=10):
+            ...    print(department)
+
+            List departments, returning 200 items per page for a maximum of 2 pages:
+
+            >>> for department in zia.users.list_departments(page_size=200, max_pages=2):
+            ...    print(department)
+        """
+        return BoxList(Iterator(self.rest, "departments", **kwargs))
+
+    def get_department(self, department_id: str) -> Box:
+        """
+        Returns the department details for a given department.
+
+        Args:
+            department_id (str): The unique identifier for the department.
+
+        Returns:
+            :obj:`Box`: The department resource record.
+
+        Examples:
+            >>> department = zia.users.get_department('99999')
+
+        """
+        return self.rest.get(f"departments/{department_id}")
+
+    def get_dept_by_name(self, name):
+        depts = self.list_departments()
+        for dept in depts:
+            if dept.get("name") == name:
+                return dept
+        return None
+
+    def list_groups(self, **kwargs) -> BoxList:
+        """
+        Returns the list of user groups.
+
+        Keyword Args:
+            **max_items (int, optional):
+                The maximum number of items to request before stopping iteration.
+            **max_pages (int, optional):
+                The maximum number of pages to request before stopping iteration.
+            **page_size (int, optional):
+                Specifies the page size. The default size is 100, but the maximum size is 1000.
+            **search (str, optional):
+                The search string used to match against a group's name or comments attributes.
+        Returns:
+            :obj:`BoxList`: The list of user groups configured in ZIA.
+
+        Examples:
+            List groups using default settings:
+
+            >>> for group in zia.users.list_groups():
+            ...    print(group)
+
+            List groups, limiting to a maximum of 10 items:
+
+            >>> for group in zia.users.list_groups(max_items=10):
+            ...    print(group)
+
+            List groups, returning 200 items per page for a maximum of 2 pages:
+
+            >>> for group in zia.users.list_groups(page_size=200, max_pages=2):
+            ...    print(group)
+
+        """
+        return BoxList(Iterator(self.rest, "groups", **kwargs))
+
+    def get_group(self, group_id: str) -> Box:
+        """
+        Returns the user group details for a given user group.
+
+        Args:
+            group_id (str): The unique identifier for the user group.
+
+        Returns:
+            :obj:`Box`: The user group resource record.
+
+        Examples:
+            >>> user_group = zia.users.get_group('99999')
+
+        """
+        return self.rest.get(f"groups/{group_id}")
+
+    def get_group_by_name(self, name):
+        groups = self.list_groups()
+        for group in groups:
+            if group.get("name") == name:
+                return group
+        return None
+
+    def list_users(self, **kwargs) -> BoxList:
+        """
+        Returns the list of users.
+
+        Keyword Args:
+            **dept (str, optional):
+                Filters by department name. This is a `starts with` match.
+            **group (str, optional):
+                Filters by group name. This is a `starts with` match.
+            **max_items (int, optional):
+                The maximum number of items to request before stopping iteration.
+            **max_pages (int, optional):
+                The maximum number of pages to request before stopping iteration.
+            **name (str, optional):
+                Filters by user name. This is a `partial` match.
+            **page_size (int, optional):
+                Specifies the page size. The default size is 100, but the maximum size is 1000.
+            **sort_by (str):
+                The field name to sort by, supported values: id, name, creationTime or modifiedTime (default to name)
+            **sort_order (str):
+                The sort order, values: ASC or DESC (default DESC)
+
+        Returns:
+            :obj:`BoxList`: The list of users configured in ZIA.
+
+        Examples:
+            List users using default settings:
+
+            >>> for user in zia.users.list_users():
+            ...    print(user)
+
+            List users, limiting to a maximum of 10 items:
+
+            >>> for user in zia.users.list_users(max_items=10):
+            ...    print(user)
+
+            List users, returning 200 items per page for a maximum of 2 pages:
+
+            >>> for user in zia.users.list_users(page_size=200, max_pages=2):
+            ...    print(user)
+
+        """
+        return BoxList(Iterator(self.rest, "users", **kwargs))
+
+    def add_user(
+        self, name: str, email: str, groups: list, department: dict, **kwargs
+    ) -> Box:
+        """
+        Creates a new ZIA user.
+
+        Args:
+            name (str):
+                User name.
+            email (str):
+                User email consists of a user name and domain name. It does not have to be a valid email address,
+                but it must be unique and its domain must belong to the organisation.
+            groups (list):
+                List of Groups a user belongs to.
+            department (dict):
+                The department the user belongs to.
+
+        Keyword Args:
+            **comments (str):
+                Additional information about this user.
+            **tempAuthEmail (str):
+                Temporary Authentication Email. If you enabled one-time tokens or links, enter the email address to
+                which the Zscaler service sends the tokens or links. If this is empty, the service will send the
+                email to the User email.
+            **adminUser (bool):
+                True if this user is an Admin user.
+            **password (str):
+                User's password. Applicable only when authentication type is Hosted DB. Password strength must follow
+                what is defined in the auth settings.
+            **type (str):
+                User type. Provided only if this user is not an end user. Accepted values are SUPERADMIN, ADMIN,
+                AUDITOR, GUEST, REPORT_USER and UNAUTH_TRAFFIC_DEFAULT.
+
+        Returns:
+            :obj:`Box`: The resource record for the new user.
+
+        Examples:
+            Add a user with the minimum required params:
+
+            >>> zia.users.add_user(name='Jane Doe',
+            ...    email='jane.doe@example.com',
+            ...    groups=[{
+            ...      'id': '49916183'}]
+            ...    department={
+            ...      'id': '49814321'})
+
+        """
+        payload = {
+            "name": name,
+            "email": email,
+            "groups": groups,
+            "department": department,
+        }
+
+        # Add optional parameters to payload
+        for key, value in kwargs.items():
+            payload[key] = value
+        return self.rest.post("users", json=payload)
+
+    def bulk_delete_users(self, user_ids: list) -> Box:
+        """
+        Bulk delete ZIA users.
+
+        Args:
+            user_ids (list): List containing id int of each user that will be deleted.
+
+        Returns:
+            :obj:`Box`: Object containing list of users that were deleted.
+
+        Examples:
+            >>> bulk_delete_users = zia.users.bulk_delete_users(['99999', '88888', '77777'])
+
+        """
+
+        payload = {"ids": user_ids}
+
+        return self.rest.post("users/bulkDelete", json=payload)
+
+    def get_user(self, user_id: str = None, email: str = None) -> Box:
+        """
+        Returns the user information for the specified ID or email.
+
+        Args:
+            user_id (optional, str): The unique identifier for the requested user.
+            email (optional, str): The unique email for the requested user.
+
+        Returns:
+            :obj:`Box`: The resource record for the requested user.
+
+        Examples
+            >>> user = zia.users.get_user('99999')
+
+            >>> user = zia.users.get_user(email='jane.doe@example.com')
+
+        """
+
+        if user_id and email:
+            raise ValueError(
+                "TOO MANY ARGUMENTS: Expected either a user_id or an email. Both were provided."
+            )
+
+        elif email:
+            user = (
+                record
+                for record in self.list_users(search=email)
+                if record.email == email
+            )
+            return next(user, None)
+
+        return self.rest.get(f"users/{user_id}")
+
+    def update_user(
+        self,
+        user_id: str,
+        **kwargs,
+    ) -> Box:
+        """
+        Updates the details for the specified user.
+
+        Args:
+            user_id (str):
+                The unique identifier for the user.
+            **kwargs:
+                Optional parameters
+
+        Keyword Args:
+            **adminUser (bool):
+                True if this user is an Admin user.
+            **comments (str):
+                Additional information about this user.
+            **department (dict, optional):
+                The updated department object. Defaults to existing department if not specified.
+            **email (str, optional):
+                The updated email. Defaults to existing email if not specified.
+            **groups (:obj:`list` of :obj:`dict`, optional):
+                The updated list of groups. Defaults to existing groups if not specified.
+            **name (str, optional):
+                The updated name. Defaults to existing name if not specified.
+            **password (str):
+                User's password. Applicable only when authentication type is Hosted DB. Password strength must follow
+                what is defined in the auth settings.
+            **tempAuthEmail (str):
+                Temporary Authentication Email. If you enabled one-time tokens or links, enter the email address to
+                which the Zscaler service sends the tokens or links. If this is empty, the service will send the
+                email to the User email.
+            **type (str):
+                User type. Provided only if this user is not an end user. Accepted values are SUPERADMIN, ADMIN,
+                AUDITOR, GUEST, REPORT_USER and UNAUTH_TRAFFIC_DEFAULT.
+
+        Returns:
+            :obj:`Box`: The resource record of the updated user.
+
+        Examples:
+            Update the user name:
+
+            >>> zia.users.update_user('99999',
+            ...      name='Joe Bloggs')
+
+            Update the email and add a comment:
+
+            >>> zia.users.update_user('99999',
+            ...      name='Joe Bloggs',
+            ...      comment='External auditor.')
+
+        """
+        payload = convert_keys(self.get_user(user_id))
+
+        # Add optional parameters to payload
+        for key, value in kwargs.items():
+            payload[snake_to_camel(key)] = value
+
+        return self.rest.put(f"users/{user_id}", json=payload)
+
+    def delete_user(self, user_id: str) -> int:
+        """
+        Deletes the specified user ID.
+
+        Args:
+            user_id (str): The unique identifier of the user that will be deleted.
+
+        Returns:
+            :obj:`int`: The response code for the request.
+
+        Examples:
+            >>> user = zia.users.delete_user('99999')
+        """
+        response = self.rest.delete(f"users/{user_id}")
+        return response.status_code