action1-mcp-server

Change group settings

action1_update_group

Destructive

Modify endpoint group properties, including names, descriptions, and advanced filters. Customize group logic to precisely control which devices are included or excluded from specific actions.

Instructions

Change group settings. Changes settings for an existing endpoint group in the specified organization. Perm: manage_endpoints.

Input Schema

Name	Required	Description
`body`	No	Request body (schema: EndpointGroupPayload)
`org_id`	No	Org UUID.
`confirm`	No	Required to execute. Exact string "YES".
`dry_run`	No	Default true (preview). Set false to execute.
`group_id`	Yes	Provide an endpoint group ID.

Output Schema

Name	Required	Description	Default
`id`	No
`name`	No
`self`	No
`tool`	No
`type`	No
`dry_run`	No
`contents`	No
`would_send`	No
`description`	No
`uptime_alerts`	No
`exclude_filter`	No
`include_filter`	No
`exclude_filter_logic`	No
`include_filter_logic`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed18 schema fields changedv0.6.0Oct 26, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

addedInput schema / properties / body / properties

Added value: +{
+  "description": {
+    "description": "The group description.",
+    "type": "string"
+  },
+  "exclude_filter": {
+    "description": "The list of endpoint exclusion filters.",
+    "items": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "field_name": {
+              "enum": [
+                "AD_organization_unit",
+                "AD_security_groups",
+                "agent_version",
+                "CPU_name",
+                "CPU_size",
+                "comment",
+                "name",
+                "video",
+                "MAC",
+                "manufacturer",
+                "platform",
+                "serial",
+                "user",
+                "WiFi",
+                "NIC"
+              ],
+              "type": "string"
+            },
+            "field_value": {
+              "description": "Exact match value or wildcard."
+            },
+            "mode": {
+              "description": "Defines matching.",
+              "enum": [
+                "include",
+                "exclude"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        {
+          "additionalProperties": {},
+          "properties": {
+            "field_name": {
+              "enum": [
+                "OS",
+                "reboot_required",
+                "subscription_status",
+                "status"
+              ],
+              "type": "string"
+            },
+            "field_value": {
+              "description": "Exact match value."
+            },
+            "mode": {
+              "description": "Defines matching.",
+              "enum": [
+                "include",
+                "exclude"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        {
+          "additionalProperties": {},
+          "properties": {
+            "field_name": {
+              "description": "Format is \"custom:{Attribute Name}\".",
+              "type": "string"
+            },
+            "field_value": {},
+            "mode": {
+              "description": "Defines matching.",
+              "enum": [
+                "include",
+                "exclude"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        {
+          "additionalProperties": {},
+          "properties": {
+            "field_name": {
+              "enum": [
+                "agent_install_date",
+                "last_seen",
+                "last_boot_time"
+              ],
+              "type": "string"
+            },
+            "field_value": {
+              "description": "Allowed formats: * `2023-07-04-2023-08-04` - from 4 July, 2023 to 4 August, 2023."
+            },
+            "mode": {
+              "description": "Defines matching.",
+              "enum": [
+                "include",
+                "exclude"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        {
+          "additionalProperties": {},
+          "properties": {
+            "field_name": {
+              "enum": [
+                "RAM",
+                "Disk"
+              ],
+              "type": "string"
+            },
+            "field_value": {
+              "description": "Allowed formats: * `524-1024` - from 524GB to 1024GB."
+            },
+            "mode": {
+              "description": "Defines matching.",
+              "enum": [
+                "include",
+                "exclude"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        {
+          "additionalProperties": {},
+          "properties": {
+            "field_name": {
+              "const": "member_of",
+              "type": "string"
+            },
+            "field_value": {
+              "description": "The endpoint group ID with the prefix \"id:\"."
+            },
+            "mode": {
+              "description": "Defines matching.",
+              "enum": [
+                "include",
+                "exclude"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        }
+      ]
+    },
+    "type": "array"
+  },
+  "exclude_filter_logic": {
+    "description": "Filter logic Boolean expression for group's exclusion filters using 1-based filter...",
+    "type": "string"
+  },
+  "include_filter": {
+    "description": "The list of endpoint inclusion filters.",
+    "items": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "field_name": {
+              "enum": [
+                "AD_organization_unit",
+                "AD_security_groups",
+                "agent_version",
+                "CPU_name",
+                "CPU_size",
+                "comment",
+                "name",
+                "video",
+                "MAC",
+                "manufacturer",
+                "platform",
+                "serial",
+                "user",
+                "WiFi",
+                "NIC"
+              ],
+              "type": "string"
+            },
+            "field_value": {
+              "description": "Exact match value or wildcard."
+            },
+            "mode": {
+              "description": "Defines matching.",
+              "enum": [
+                "include",
+                "exclude"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        {
+          "additionalProperties": {},
+          "properties": {
+            "field_name": {
+              "enum": [
+                "OS",
+                "reboot_required",
+                "subscription_status",
+                "status"
+              ],
+              "type": "string"
+            },
+            "field_value": {
+              "description": "Exact match value."
+            },
+            "mode": {
+              "description": "Defines matching.",
+              "enum": [
+                "include",
+                "exclude"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        {
+          "additionalProperties": {},
+          "properties": {
+            "field_name": {
+              "description": "Format is \"custom:{Attribute Name}\".",
+              "type": "string"
+            },
+            "field_value": {},
+            "mode": {
+              "description": "Defines matching.",
+              "enum": [
+                "include",
+                "exclude"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        {
+          "additionalProperties": {},
+          "properties": {
+            "field_name": {
+              "enum": [
+                "agent_install_date",
+                "last_seen",
+                "last_boot_time"
+              ],
+              "type": "string"
+            },
+            "field_value": {
+              "description": "Allowed formats: * `2023-07-04-2023-08-04` - from 4 July, 2023 to 4 August, 2023."
+            },
+            "mode": {
+              "description": "Defines matching.",
+              "enum": [
+                "include",
+                "exclude"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        {
+          "additionalProperties": {},
+          "properties": {
+            "field_name": {
+              "enum": [
+                "RAM",
+                "Disk"
+              ],
+              "type": "string"
+            },
+            "field_value": {
+              "description": "Allowed formats: * `524-1024` - from 524GB to 1024GB."
+            },
+            "mode": {
+              "description": "Defines matching.",
+              "enum": [
+                "include",
+                "exclude"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        {
+          "additionalProperties": {},
+          "properties": {
+            "field_name": {
+              "const": "member_of",
+              "type": "string"
+            },
+            "field_value": {
+              "description": "The endpoint group ID with the prefix \"id:\"."
+            },
+            "mode": {
+              "description": "Defines matching.",
+              "enum": [
+                "include",
+                "exclude"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        }
+      ]
+    },
+    "type": "array"
+  },
+  "include_filter_logic": {
+    "description": "Filter logic Boolean expression for group's inclusion filters using 1-based filter...",
+    "type": "string"
+  },
+  "name": {
+    "description": "The group name.",
+    "type": "string"
+  },
+  "uptime_alerts": {
+    "additionalProperties": {},
+    "properties": {
+      "offline_alerts_delay": {
+        "description": "Notify when endpoints have been offline for more than minutes",
+        "type": "number"
+      },
+      "offline_alerts_enabled": {
+        "enum": [
+          "yes",
+          "no"
+        ],
+        "type": "string"
+      },
+      "online_alerts_enabled": {
+        "enum": [
+          "yes",
+          "no"
+        ],
+        "type": "string"
+      },
+      "user_ids_for_notification": {
+        "description": "The list of user ids to be notified",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  }
+}

changedOutput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

changedOutput schema / additionalProperties
```
Previous value: -trueNew value: +{}
```
addedOutput schema / properties / contents
```
Added value: +{}
```
addedOutput schema / properties / description
```
Added value: +{}
```
addedOutput schema / properties / dry_run
```
Added value: +{}
```
addedOutput schema / properties / exclude_filter
```
Added value: +{}
```
addedOutput schema / properties / exclude_filter_logic
```
Added value: +{}
```
addedOutput schema / properties / id
```
Added value: +{}
```
addedOutput schema / properties / include_filter
```
Added value: +{}
```
addedOutput schema / properties / include_filter_logic
```
Added value: +{}
```
addedOutput schema / properties / name
```
Added value: +{}
```
addedOutput schema / properties / self
```
Added value: +{}
```
addedOutput schema / properties / tool
```
Added value: +{}
```
addedOutput schema / properties / type
```
Added value: +{}
```
addedOutput schema / properties / uptime_alerts
```
Added value: +{}
```
addedOutput schema / properties / would_send
```
Added value: +{}
```

First observedv0.5.0Jun 27, 2026

TDQS

C2.9/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already flag destructiveHint=true, idempotentHint=false and openWorldHint=true, so the risk profile is carried structurally. The description adds one genuinely useful non-schema fact, the required permission (manage_endpoints), but says nothing about whether omitted fields are cleared, whether the operation is reversible, or that dry_run defaults to true — all material for a destructive update.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, but sentence two ('Changes settings for an existing endpoint group in the specified organization') largely restates sentence one. The only non-redundant content is the permission requirement in the third sentence; the restate could be replaced by behaviorally useful detail.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool takes a deeply nested payload with complex include/exclude filter DSL and is flagged destructive, yet the description omits update semantics (full replace vs partial), the default-preview behavior, and any recovery guidance. An output schema exists so return values needn't be explained, but the mutation semantics gap is significant.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and every parameter, including the nested body, include_filter/exclude_filter arrays and the confirm/dry_run pair, is documented in the schema itself. The description adds no parameter meaning beyond that, so baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: change settings for an existing endpoint group in a given organization. The word 'existing' implicitly separates it from action1_create_endpoint_group, but no sibling is named and the scope of 'settings' (name, description, filter lists, alerting) is left to the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this versus action1_create_endpoint_group, action1_delete_group, action1_update_endpoint, or action1_move_endpoint. Nothing explains the dry_run/confirm workflow that gates execution, which is exactly the sort of routing information an agent needs here.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server