get_zia_user_groups

Removed value: -false

Added value: +"Defined By"

Added value: +"Group Id"

Added value: +"Name"

Added value: +"Page"

Added value: +"Page Size"

Previous value: -"Optional JMESPath expression applied to the results after the API call, for client-side filtering and projection. Field names are exactly what the Zscaler API returns. Examples: \"[?enabled==`true`]\", \"[*].{name: name, id: id}\", \"length(@)\". Omit to get the full records."New value: +"Optional JMESPath expression applied to the results after the API call, for client-side filtering and projection. Examples: \"[?enabled==`true`]\", \"[*].{name: name, id: id}\", \"length(@)\". Omit to get the full records. IMPORTANT: field names are the keys of the returned records, which are usually snake_case (`custom_category`) even where the Zscaler API documents camelCase (`customCategory`) — guessing the spelling yields an empty list that looks like a real answer. If you have not already seen a record from this tool, call it once without `query` and read the keys off the response."

Added value: +"Query"

Added value: +"Search"

Added value: +"Sort By"

Added value: +"Sort Order"

Added value: +"get_zia_user_groupsArguments"

Added value: +false

Removed value: -{
-  "const": "read",
-  "default": "read",
-  "description": "Operation to perform. Use 'read' to paginate/filter groups or fetch a single group by ID.",
-  "title": "Action",
-  "type": "string"
-}

Removed value: -"String value defined by the group name or other applicable attributes. Used to further filter results."

Removed value: -"Defined By"

Previous value: -[
-  {
-    "type": "integer"
-  },
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Removed value: -"ID of the user group. When provided, returns a single group; otherwise returns a list of groups."

Removed value: -"Group Id"

Removed value: -"Case-insensitive substring match on the group's name field. Resolved client-side AFTER fetching the full group list, so names like 'A000', 'a000', 'HR', 'finance' all match regardless of the underlying name's casing. Use this when you have a literal group name from the admin and just need to find its ID. The server-side `search` parameter is unreliable for groups (it sometimes matches user login IDs instead of group names) — prefer `name` for find-by-name workflows."

Removed value: -"Name"

Removed value: -"Page offset for pagination when listing groups."

Removed value: -"Page"

Removed value: -"Page size for listing groups. Default is 100; maximum is 1000."

Removed value: -"Page Size"

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Optional JMESPath expression applied to the results after the API call, for client-side filtering and projection. Field names are exactly what the Zscaler API returns. Examples: \"[?enabled==`true`]\", \"[*].{name: name, id: id}\", \"length(@)\". Omit to get the full records."
+}

Removed value: -"Server-side query forwarded to the ZIA list_groups endpoint. ZIA's documented behavior here is unreliable (the API has been observed to match against user login IDs rather than group names). Prefer `name` for case-insensitive substring matching on the group's name. Use `search` only when you specifically need the server-side semantics."

Removed value: -"Search"

Removed value: -{
-  "default": "zia",
-  "description": "Zscaler service name. Always 'zia' for this tool.",
-  "title": "Service",
-  "type": "string"
-}

Removed value: -"Sort field for listing groups. Supported: id, name, expiry, status, external_id, rank, mod_time."

Removed value: -"Sort By"

Removed value: -"Sort order for listing groups. Supported: asc, desc, rule_execution."

Removed value: -"Sort Order"

Removed value: -"zia_user_group_managerArguments"

Previous value: -{
-  "properties": {
-    "result": {
-      "anyOf": [
-        {
-          "additionalProperties": true,
-          "type": "object"
-        },
-        {
-          "items": {
-            "additionalProperties": true,
-            "type": "object"
-          },
-          "type": "array"
-        }
-      ],
-      "title": "Result"
-    }
-  },
-  "required": [
-    "result"
-  ],
-  "title": "zia_user_group_managerOutput",
-  "type": "object"
-}New value: +null