timeline_edit_hole
Modify existing hole features by updating diameter, depth, tip angle, counterbore, or countersink parameters, reverting changes automatically if the model enters an error state.
Instructions
Change an existing hole: diameter, depth (distance extents only), tip_angle,
counterbore_diameter/depth (counterbore holes), countersink_diameter/angle
(countersink holes). Lengths in mm (or units), angles in degrees.
Example: timeline_edit_hole(feature=, diameter=6.6, depth=12).
Returns {"feature": item, "changed": [{"key", "parameter", "old_expression", "new_expression", "value", "value_unit"}]} (values in mm / deg). All given keys are applied together; if the feature (or any other) falls into the error state everything is reverted and the call fails with FUSION_API_ERROR, details.reverted = true — unless allow_errors=true. A key that does not apply to this feature fails with INVALID_PARAMS and details.available_keys; no key at all fails with 'nothing to change'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | Number in mm (or `units`), or a Fusion expression ('30 mm', 'width / 2') | |
| units | No | Unit of plain length numbers | mm |
| feature | Yes | Feature ref from timeline_list (or 'timeline:<name>') | |
| diameter | No | Number in mm (or `units`), or a Fusion expression ('30 mm', 'width / 2') | |
| tip_angle | No | Number in degrees, or a Fusion expression ('15 deg', 'a / 2') | |
| allow_errors | No | Keep the change even if a feature falls into the error state (default: revert and fail) | |
| counterbore_depth | No | Number in mm (or `units`), or a Fusion expression ('30 mm', 'width / 2') | |
| countersink_angle | No | Number in degrees, or a Fusion expression ('15 deg', 'a / 2') | |
| counterbore_diameter | No | Number in mm (or `units`), or a Fusion expression ('30 mm', 'width / 2') | |
| countersink_diameter | No | Number in mm (or `units`), or a Fusion expression ('30 mm', 'width / 2') |