purge_orphaned_datablocks
Removes unused (orphaned, zero-user) Blender datablocks from memory to reduce clutter, with optional recursive purging of newly orphanned items.
Instructions
Safely purges unused (orphaned, zero-user) Blender datablocks from memory using bpy.data.orphans_purge. WARNING: Potentially irreversible operation that removes unlinked meshes, materials, textures, curves, and actions.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "purge_orphaned_datablocks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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. | |
| do_local_ids | No | Whether to purge local datablocks. Defaults to True. | |
| do_recursive | No | Whether to recursively purge datablocks that become orphaned during the purge pass. Defaults to True. | |
| do_linked_ids | No | Whether to purge linked datablocks from external libraries. Defaults to True. |