Register Handle
register_handleAdds an existing FreeCAD object to AnkusDrive’s handle table, enabling later tool calls to reference it by handle after script runs or document opens.
Instructions
Register an existing FreeCAD object into the AnkusDrive handle table. Use after run_script (when auto_register=False) or after open_document to bring objects into the handle ecosystem so subsequent tool calls accept them via handle.
object: the FreeCAD object's .Name (e.g. 'Helix001', 'Cut'). prefix: handle prefix (default 'manual'). Each call returns a fresh handle; registering the same object twice produces two aliases. Returns {handle, name, type, label}.
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": {
"object": "<object>"
},
"name": "register_handle"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| object | Yes | ||
| prefix | No | manual | |
| workspace | No | Run this call in this named workspace |