decorate_during_print_fleet
Apply the same decoration to multiple paused 3D printers at once, so a fleet can resume with consistent debossed designs.
Instructions
Apply the same decoration to N paused printers at once (Business+).
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": {
"decoration": "<decoration>",
"printers": "<printers>"
},
"name": "decorate_during_print_fleet"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bevel | No | Slant the carved walls over the top layers for cleaner edges. Defaults to ``True``. Default: true. | |
| bed_temp | No | Bed temperature, read and checked the same way as ``hotend_temp``. | |
| depth_mm | No | Deboss depth in mm, (0, 5], the same on every printer. Defaults to 1.2. Default: 1.2. | |
| printers | Yes | Required, non-empty: one spec dict per paused printer, as described above. Names must be unique (an entry without one is ``"default"``); duplicates are refused. | |
| threshold | No | Heightmap value above which a pixel is carved away (0.0-1.0). Defaults to 0.35. Default: 0.35. | |
| decoration | Yes | Plain-language spec string (``photo:``, ``logo:``, a texture name, or a description), applied to every printer. | |
| hotend_temp | No | Nozzle temperature for every printer's resume. Unset, each printer uses its own print's, read off its G-code. | |
| image_scale | No | 0.0-1.0, what fraction of each top face the image fills. Defaults to 0.7. Default: 0.7. | |
| aspect_policy | No | ``"auto_crop"`` (default), ``"auto_scale"`` or ``"strict"``: how to handle an aspect mismatch between the image and the top face. Default: "auto_crop". | |
| filament_type | No | The prints' material, applied to every printer. Unset, Kiln reads each print's own; a printer whose print names none is refused. | |
| parent_design_id | No | Optional design these prints derive from, recorded in each session's provenance. Default: "". |