Important!
The 3D print API is shutting down on January 15, 2017. See our end of life notice for more information.
Print Commands¶a>
Forge members can remotely control printers they are registered with by sending them printer commands or job commands. To send a printer command the member must be the printer owner or receive authorization from the printer owner (is_printer_scoped
= true
). To send job commands the member must either be the printer owner or the owner of the submitted job (is_job_scoped
= true
).
Note that jobs running on a printer that were initiated outside of Forge are recognized and assigned to the printer owner, who can control them.
The following commands are recognized by Forge. Specific printer firmware may recognize additional commands, and the firmware response to a particular command may differ between printers.
Command |
Description |
Command Scope |
---|---|---|
pause | Pause a running job. | Job |
resume | Resume a paused job. | Job |
cancel | Cancel a running or queued job. | Job |
reset | Reboot the printer. | Printer |
calibrate | Run a printer specific calibration procedure. | Printer |
firmware_upgrade | Call must provide a public URL for the firmware location. | Printer |
log | Return a public URL set by the manufacturer containing the current printer’s log. | Printer |
home | Moves all actuators to their home configuration. | Printer |
park | Moves all actuators to their park configuration. | Printer |
request_settings | Get the printer settings. | Printer |
settings | Set printer-specific settings by setting the settings attribute. |
Printer |