move_instance
Move an instance and all its descendants under a new parent, returning the updated path as a single undoable Studio step. Use it to reorganize hierarchies without copying or renaming them.
Instructions
Move an instance (with its descendants) under a different parent and return its new path. Recorded as one Studio undo step. To change only the name use rename_instance; to keep the original and place a copy, use clone_instance.
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": {
"path": "<path>",
"newParentPath": "<newParentPath>"
},
"name": "move_instance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Instance to move. Dot path from the DataModel root, e.g. "Workspace.Map.Door" or "StarterGui.HUD.Frame". A leading "game." is optional; a duplicate sibling name takes the suffix Tufan prints, e.g. "Part (2)". | |
| place | No | Target place (PlaceId or project name). Defaults to the bound/sole connected place. | |
| newParentPath | Yes | New parent. Dot path from the DataModel root, e.g. "Workspace.Map.Door" or "StarterGui.HUD.Frame". A leading "game." is optional; a duplicate sibling name takes the suffix Tufan prints, e.g. "Part (2)". |