Saw settings explorer

Linear stock is cut to length, so there is no layout to arrange and it takes no cut type and no cut direction at all. Roll stock rips one way, across the roll (w).

1. 1 linear.no-cut-type-or-preference coerce info

   Linear stock has no cut type or cut preference

   Linear stock (bars, profiles, lengths) is cut to length; the optimiser arranges nothing on it, so a cut type or cut preference sent with linear stock is dropped rather than applied.

   reads stockType → writes cutTypecutPreference

2. 2 cut-type.default default info

   cutType defaults to the first cut type the stock type accepts

   cutType is optional. When omitted, the stock type's first accepted cut type is used (sheet and roll: guillotine; linear stock takes none).

   reads stockTypecutType → writes cutType

3. 3 cut-type.valid-for-stock clamp warning

   cutType must be one the stock type accepts

   Each stock type accepts a fixed set of cut types (sheet: guillotine, efficiency, beam, nesting; roll: guillotine, efficiency, nesting; linear: none). A cutType outside that set resolves to the first accepted one.

   reads stockTypecutType → writes cutType

4. 4 cut-preference.valid-for-stock-cut-type clamp warning

   cutPreference must be one the (stock type, cut type) pair accepts

   Only the guillotine family (guillotine, beam) has a cut direction: sheet stock accepts l, w or flex; roll stock rips one way (w). Efficiency, nesting and linear have no direction, so a value sent for them is cleared.

   reads stockTypecutTypecutPreference → writes cutPreference

5. 5 cut-preference.default default info

   cutPreference defaults to length-first

   A guillotine-family saw with no cut preference cuts length-first (l), or the only direction the stock allows (roll: w).

   reads stockTypecutTypecutPreference → writes cutPreference

6. 6 stacking-mode.default default info

   stackingMode defaults by saw type: dimensions on a beam saw, identical otherwise

   Jon, 2026-10-01: now that a stack returns every part with its own identity and label per sheet, a BEAM saw stacks identical patterns by footprint ('dimensions') unless the request says otherwise; every other saw keeps 'identical' (the same part on every sheet). An explicit mode always wins.

   reads cutTypeoptions.stackingMode → writes options.stackingMode

7. 7 stacking-mode.none-for-roll coerce warning

   Roll stock cannot stack

   Roll stock is a single continuous length; there are no sheets to stack, so any stacking mode is forced to none.

   reads stockTypeoptions.stackingMode → writes options.stackingMode

8. 8 min-spacing.efficiency-only coerce warning

   Part spacing only applies to efficiency packing

   Part-to-part spacing is an efficiency-packing concept. The guillotine family and nesting derive their gaps from the blade width (kerf), so a spacing value sent for them is zeroed rather than carried as a setting the layout never honours.

   reads cutTypeoptions.minSpacingoptions.minSpacingDimension.dimensionoptions.minSpacingDimension.minSpacing → writes options.minSpacingoptions.minSpacingDimension.dimensionoptions.minSpacingDimension.minSpacing

9. 9 strategy.time-ignored-for-beam coerce warning

   Beam saws ignore guillotineOptions.strategy 'time'

   'time' trades material efficiency for layouts whose strips share cut positions, so a manual operator moves the fence fewer times. A beam saw positions its fence automatically for every cut, so the trade costs material and buys nothing — the setting is resolved to 'efficiency' rather than rejected, and the job runs.

   reads cutTypeguillotineOptions.strategy → writes guillotineOptions.strategy

10. 10 algorithm.ineligible ignore info

    The chosen optimisation model does not fit this saw

    The Max tiers are gated per family (rectangle-guillotine-max-* need a beam or guillotine saw, an UNCAPPED job — no maxPhase from the saw or its profile, RM-458 — and a part cap; irregular-nesting-max-* need a nesting saw). A model that does not fit the job safely falls back to the default — it never errors.

    reads algorithmcutType → writes nothing (the value is accepted, it just has no effect)

11. 11 profile.max-nested-cut-depth-sets-max-phase derive info

    A saw profile with a nesting-depth limit sets maxPhase

    When a recognised saw (vendor + model) declares a maximum nested cut depth and the request leaves maxPhase at 0 (no limit), the profile's depth is applied so the optimiser never plans a pattern the saw's controller rejects.

    reads guillotineOptions.maxPhase → writes guillotineOptions.maxPhase

12. 12 profile.cut-preference-clamped derive warning

    A saw profile's supported cut directions clamp cutPreference

    A saw that physically cannot rip short-side-first must not be handed a 'w' job. When a recognised profile declares supportedCutPreferences, a direction outside the set is steered to 'flex' if allowed (the optimiser then chooses per board within the set), else the first allowed direction.

    reads cutPreference → writes cutPreference

Kinds: default fills an unset value · clamp replaces a value the matrix does not allow · coerce rewrites a value another setting makes meaningless · ignore changes nothing and explains why the value will not take effect · derive means a recognised saw profile supplied or narrowed the value.

Saw settings it applies are saw fields filled in when you leave them out, so send your own and yours stands. Limits it plans within are enforced whatever you send, so the pattern is one this saw can cut. Export file affects only the file written for the saw, never the layout. "Validated" means output for that saw has been checked against the saw's own control software.

The full request reference is in the v3 API reference, covering every endpoint, every field and runnable samples, and the narrative walkthrough is in the API guide.