Cut a model that does not fit the bed
split_for_printingDestructive
Cut one body in a project into two halves at a plane, with a joint so they go back together after printing. This is the answer to "my model is too big for my printer". Both halves stay fully parametric — each is the original body intersected with a half-space, not a flattened mesh — so they still export as solids and still open for editing. Pick the joint by what the print needs: dowel puts a socket in BOTH halves and prints the pin separately, so neither half has anything standing off its cut face and a wrong fit costs a two-gram reprint instead of a whole half; pin and tenon grow the key out of one half; bolt is the only one that comes apart again. Omit position to cut through the middle of the body on that axis.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fit | No | How much slack the key gets in its socket. Defaults to normal (0.4 mm total). Use `custom` with `gap` to set it yourself. | |
| gap | No | TOTAL clearance across the key in mm when `fit` is custom, as a fit coupon reads it (each side gets half). Default 0.4. | |
| axis | No | Which way the plane faces. Cut a tall part across z, a long one across x. Defaults to z. | |
| size | No | Key size in mm — pin/dowel diameter, tenon width, bolt size. Defaults to 5. | |
| count | No | How many keys across the cut face (1-6). Defaults to 2. | |
| depth | No | How far a key reaches into the far half, mm. For a dowel, into EACH half. Defaults to 6. | |
| joint | No | Defaults to pin. | |
| shape | No | Key cross-section (pin and dowel only). Round lets the halves spin about a single key; any other shape stops that. Defaults to circle. | |
| style | No | Straight or tapered (pin and dowel only). Tapered is easier to start and shrinks the flat bridge over a blind socket. Defaults to prism. | |
| nodeId | Yes | The top-level body to cut, from `get_project`. A nested node, a generator or a component instance cannot be cut — the cut is authored in world coordinates. | |
| version | No | The `version` get_project reported, so a concurrent change is detected rather than overwritten. | |
| position | No | Where the plane sits along `axis`, in world mm. Must pass THROUGH the body — the reply names the legal range if it does not. Omit to cut at the middle, which is almost always what you want. | |
| projectId | Yes | The project containing the body to cut. |