Print Jobs
Public

Plan which printers can take a plate and what to load

Changed on

Takes the plate's effective filament requirements and returns the printers where every filament has a bay, ranked by fewest load and swap actions, then by Smart Queue match score, then by name. Each suggestion lists only what is still missing, as load actions that name the exact bay and its text. This is material-routing advice: connectivity, readiness, maintenance and current work are not checked, and a suggestion does not reserve a printer or authorize changing a bay during a print. Printers with no material route are listed with why. Name printers with printer_id or printer_ids, up to 25; otherwise up to 100 printers are evaluated in name order. An unknown or inaccessible named printer returns 404. Reading sends nothing to a printer, slices nothing and creates no job.

post/v1/print-jobs/plan

Request

Request body

filament_source'any' | 'ams' | 'external_spool'

Where the job may take filament from. Defaults to any.

nozzle_diametersnumber[]

Nozzle sizes in millimetres the plate was sliced for, in nozzle order. Omit when unknown: no bay is then ruled out by size.

printer_idstring uuid

Evaluate only this printer.

printer_idsstring[]

Evaluate only these printers. Omit both to evaluate the organization's printers in name order.

Response

Default Response

evaluatedinteger required
truncatedboolean required

Changes