insert_keyframe
Inserts, updates, or deletes animation keyframes for Blender object location, rotation, and scale at specified frames, with verified channel bounds and optional axis targeting.
Instructions
Inserts, updates, or deletes animation keyframes for supported object properties (location, rotation_euler, scale) at specified frames with verified channel bounds.
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>",
"property_path": "<property_path>",
"frame": "<frame>"
},
"name": "insert_keyframe"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Target object name. | |
| frame | Yes | Frame number for keyframe insertion/deletion. | |
| index | No | Array index for multi-axis properties: -1 for all axes, or 0 (X), 1 (Y), 2 (Z). Defaults to -1. | |
| value | No | Optional numeric value or 3-element array to set prior to inserting the keyframe. | |
| action | No | Operation to perform: 'insert' (default) or 'delete'. | insert |
| 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. | |
| bone_name | No | Optional pose bone name if keyframing an armature bone in pose mode. | |
| property_path | Yes | Property to keyframe: 'location', 'rotation_euler', or 'scale'. |