Materials Create Org Grade
materials_create_org_gradeDestructive
Register a material grade private to your organization.
For a material the standards catalogue does not carry — a house designation, an internal blank, a supplier-specific grade. Only your organization can see or resolve it, and it prices exactly like a catalogue grade: give it a €/kg rate on an environment, or let the category default stand until you do.
The designation is fixed once registered, and one that already resolves for you — a catalogue code, a standard alias, or another of your own grades — is refused.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Human-readable name of the material. | |
| category | Yes | Broad material family the grade belongs to (e.g. carbon_steel, aluminium). | |
| attributes | No | The material statement for this grade: mechanical and physical figures (`yield_mpa`, `tensile_mpa`, `hardness_hb`, …) and the categorical route gates (`laser_cuttable`, `weldability_class`, `heat_treatable`, …). A closed vocabulary, not free-form: an unknown key or a verdict outside a gate's set is refused (422) rather than stored, because a key nothing reads and a misspelled one are indistinguishable on the quote. `GET /materials/attribute-vocabulary` lists every accepted key, its unit or its verdicts, and what the costing engine does with it. | |
| designation | Yes | Your designation for the grade (e.g. 'WS-42-Blank'). Letters, digits, dots and hyphens; rendered as entered, stored URN-safe. Must not collide with a catalogue code. | |
| density_kg_per_m3 | Yes | Material density in kilograms per cubic metre — steel is about 7850, aluminium about 2700. Mind the unit: a value in g/cm³ is 1000x too small and is rejected. | |
| iso_machining_group | Yes | ISO 513 machining group (P/M/K/N/S/H). Shown on the grade; the cutting data itself comes from `workpiece_group_code` when set, and from the category's default bin otherwise. | |
| workpiece_group_code | No | Leaf of the workpiece material tree this grade machines as — `P2.2` for a hardened-and-tempered low-alloy steel, `M3.1` for a duplex stainless, `N1.2` for an age-hardened aluminium. Pick it from `GET /materials/workpiece-groups`. This is what selects the grade's cutting speeds and forces; leave it unset to price on the category's default cutting data. |