delete_prim
Deletes a USD prim and its children by removing the stage edit-layer entry at the given path; refuses prims owned by other layers or references, so hide those with set_visibility.
Instructions
Delete a prim and everything under it, by removing what the stage's edit layer holds at that path.
A prim another layer defines too, or one a reference or payload on a prim above brings, such as a part of a referenced asset, can't be deleted this way: the call is refused, saying why, and nothing changes; set_visibility hides such a prim, or its instance for a prim inside one. Kit's undo doesn't record the delete, and the file on disk keeps the prim until save_scene. An error when no prim is there.
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": {
"prim_path": "<prim_path>"
},
"name": "delete_prim"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prim_path | Yes | Full USD path of the prim, e.g. "/World/Robot" |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |