Tools Create Tool
tools_create_toolDestructive
Add a tool to your organization's library, optionally with its per-material cutting data.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Tool kind (VDI 2852 class), e.g. end_mill or drill. | |
| name | Yes | Human-readable name of the tool. | |
| spec | No | Kind-specific properties — e.g. a press-brake die's V opening and load rating, a saw blade's kerf and pitch, a plasma consumable set's amperage. Validated per kind; empty for rotating cutters, whose geometry uses the fields above. | |
| notes | No | Free-form shop notes. | |
| teeth | No | Number of cutting edges / flutes / blade teeth. | |
| vendor | No | Tool manufacturer / vendor. | |
| coating | No | Coating designation (e.g. TiAlN), if any. | |
| item_no | No | Vendor item / order number. | |
| price_eur | No | Replacement price, in EUR. | |
| parameters | No | Optional cutting-data rows to create with the tool — one row per parameter, keyed (material, operation, size, quality). | |
| diameter_mm | No | Cutting diameter, in millimetres (null for turning inserts). | |
| tool_life_min | No | Expected tool life in cutting minutes (per edge set). | |
| cutting_material | No | Cutting-material class (HSS, carbide, coated carbide, ...). | carbide |
| attach_to_environment_ids | No | Costing environments the new tool joins (D7 — membership is always explicit). Omit for the documented default: every current environment of your organization. Send [] to attach nowhere (the tool exists in the crib but prices nothing until attached). |