delete_object
Safely removes an object from the active Blender scene, optionally unlinking unreferenced mesh, curve, camera, or light data; destructive changes require approval.
Instructions
Safely delete an object from the active scene, optionally unlinking its underlying datablock if no other objects reference it. Destructive operation requiring approval.
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": {
"name": "<name>"
},
"name": "delete_object"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Exact name of the object to delete. | |
| task_id | No | Optional task or workflow identifier. | |
| approved | No | DEPRECATED / UNTRUSTED: Client-supplied approval flags in tool arguments are not trusted as proof of human consent. | |
| unlink_data | No | Whether to remove the underlying mesh/curve/camera/light data if unreferenced (default True). |