transform_object
Transform an existing Blender object by setting or offsetting its location, rotation, and scale, with absolute or relative modes; requires trusted approval for scene changes.
Instructions
Transform an existing object in the active Blender scene by setting or offsetting its location, rotation (Euler in radians), and/or scale. Requires explicit user approval through a trusted approval mechanism to authorize scene modification. Client- or model-supplied approval flags in tool arguments are untrusted and cannot authorize mutations. Supports absolute transform assignment (default) or relative offset accumulation ('relative': True).
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": "transform_object"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Exact name of the existing object in the scene to transform. | |
| scale | No | 3D scale factors [sx, sy, sz]. Must be positive numbers (>= 0.0001). When relative=False, sets absolute scale; when relative=True, multiplies current scale. | |
| task_id | No | Optional task or workflow identifier for grouping related scene mutation operations. | |
| approved | No | DEPRECATED / UNTRUSTED: Client-supplied approval flags in tool arguments are not trusted as proof of human consent. Mutations must be approved through a trusted approval mechanism. | |
| location | No | 3D coordinates [x, y, z] in Blender units. When relative=False, sets absolute location; when relative=True, adds translation delta. | |
| relative | No | If True, transforms are applied relative to current object state (location += loc, rotation += rot, scale *= scale). Defaults to False (absolute assignment). | |
| bone_name | No | Optional pose bone name if transforming an armature bone in pose mode. | |
| rotation_euler | No | 3D Euler rotation angles [rx, ry, rz] in radians. When relative=False, sets absolute rotation; when relative=True, adds angular delta. |