edit_armature_bones
Add, edit, or remove armature bones in Blender Edit Mode with rollback protection, atomic operations, hierarchy parenting, and connect flags.
Instructions
Edits armature bones in Edit Mode with rollback protection: add_bone, edit_bone, remove_bone, hierarchy parenting, connect flags.
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": {
"armature_name": "<armature_name>"
},
"name": "edit_armature_bones"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| head | No | Head [x, y, z] shortcut for single operation. | |
| name | No | Single bone name shortcut if 'operations' array is omitted. | |
| roll | No | Bone roll in radians shortcut for single operation. | |
| tail | No | Tail [x, y, z] shortcut for single operation. | |
| action | No | Single operation action shortcut if 'operations' array is omitted. | |
| parent | No | Parent bone name shortcut for single operation. | |
| 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. | |
| operations | No | List of bone operations to apply atomically. | |
| use_deform | No | Deform flag for single operation. | |
| use_connect | No | Connect head to parent tail flag for single operation. | |
| armature_name | Yes | Target armature object name. | |
| expected_snapshot_id | No | Optimistic concurrency state hash. Mutation is rejected if state changed. |