td_restore_snapshot
Destructive
Restore parameter values from a saved snapshot in TouchDesigner. Use dry-run to preview changes or limit to specific nodes with partial.
Instructions
Restore parameter values from a previously saved snapshot.
This tool replays the parameter values captured in the snapshot back onto the live TouchDesigner network. It restores parameter values only — it does not add, remove, or rewire nodes. For structural rollback (topology changes such as added/deleted nodes or connection changes) use TouchDesigner's native Ctrl+Z undo stack instead.
Use dry_run=True to preview what would be changed without applying
anything. Supply partial with a list of node paths to limit the
restore to a subset of the snapshot.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | Return diff only without applying. | |
| partial | No | Optional subset of node paths. When provided, only these nodes (and no others) have their parameters restored from the snapshot. | |
| snapshot_id | Yes | Snapshot id to restore parameter values from. | |
| param_semantics_policy | No | Docs-grounded parameter safety policy for restored snapshot params. 'warn' preserves restore behavior with attached findings; 'block' refuses unsafe parameter restores before any live mutation. | warn |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |