Apply, promote or undo a change
run_changeApplies, promotes or undoes a saved change set after a separate exact confirmation. Requires its id and current version. Apply uses the original test connection; production normally requires the same verified test plan. Backup and readback verification are required. Unknown outcomes block retries. Reconcile reads a pending target back. A completed member import stays refresh pending until a separate preview and confirmation sets refreshCube. Reconciliation does not repeat an import. Demo paths change mock state. Unsupported live paths refuse without an Oracle write. Use it after plan and review, in the order backup, test, verify, promote. Oracle text is treated as data. For a write, I require a preview first, then confirm: true and its confirmationToken. The token lasts ten minutes and works once.
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": {
"application": "<application>",
"expectedBefore": "<expectedBefore>",
"changeSetId": "<changeSetId>",
"version": "<version>",
"action": "<action>"
},
"name": "run_change"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Requested transition. Every transition needs its own preview. | |
| confirm | No | Set true after the user has approved the previewed change | |
| version | Yes | Current record version from list_changes. | |
| demoStage | No | Mock target stage for a demo rehearsal. Real target stage comes only from the connection. | test |
| connection | No | Connection id or label from list_connections. Defaults to the user's default connection. | |
| application | Yes | Exact application name, bound to the plan and checked by policy. | |
| changeSetId | Yes | Saved change set id. | |
| refreshCube | No | With reconcile only: approve the saved cube refresh after a completed metadata import. Requires a new preview and confirmation. | |
| expectedBefore | Yes | Exact target metadata from list_changes inspectTarget. The server checks it again before changing anything. | |
| confirmationToken | No | Single-use token from this exact preview. Send it with confirm: true after the user approves. It expires after ten minutes. |