update_common_event
Update common event properties like name, trigger, switch ID, or command list. Validation rejects invalid command lists unless overridden, with dry-run preview of changes.
Instructions
Update a common event's properties (shallow merge into the existing record). Use for name, trigger, switchId, or to replace the whole command list. A structurally invalid command list refuses the write (nothing is saved) — pass force: true to override.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"commonEventId": "<commonEventId>",
"updates": "<updates>"
},
"name": "update_common_event"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | Write even if validation finds structural problems (wrong parameter count, unterminated command list). Off by default: such a write is refused and nothing is written. Advisory warnings never block regardless. | |
| dryRun | No | Preview only: return a diff of what would change without writing to disk. | |
| updates | Yes | Object containing common event properties to update (name, trigger, switchId, list) | |
| verbose | No | Echo the full written record instead of the default summary. Off by default: the response reports identity, counts and command-list shape, which is what you would assert on, and omits the parameters/conditions you would only re-read. Read the full record with the matching get_* tool. | |
| commonEventId | Yes | The ID of the common event to update |