sn_plan_change
Plans a ServiceNow record change or creation without writing it, capturing before/after values and dictionary warnings so users can review and fix the plan before applying.
Instructions
Propose a change to one record without writing it. Give sys_id to change an existing record, or leave it out to plan a new one. The server reads the current values, saves a plan with the before and after value of every field, and returns it with a plan_id. Only reads reach ServiceNow. It also checks each value against the dictionary (choice lists, references, whole numbers, true or false, length, read only, and for a new record unknown and mandatory columns) and returns what it finds as warnings, so a plan can be fixed before anyone reviews it. Give reference fields as sys_ids and choice fields as stored values, the form sn_table_get returns, so the plan compares like with like. Show the changes to the user and call sn_apply_plan only after they agree.
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": {
"table": "<table>",
"record": "<record>"
},
"name": "sn_plan_change"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| table | Yes | Table name, lowercase letters, digits and underscores only. Example: incident. | |
| reason | No | Why the change is made. Kept in the plan for whoever reviews it. | |
| record | Yes | Field names and the values they should have. Example: {"state": "2", "assigned_to": "<sys_id of the user>"}. | |
| sys_id | No | The sys_id of the record to change: 32 hex characters. Leave out to plan a new record. |