emergency_status
Retrieve emergency stop latch status for a specific printer or all printers. Indicates active e-stops and blocked print commands until cleared with an acknowledgement note.
Instructions
Get the emergency stop latch status for one printer or the entire fleet.
Returns whether an emergency stop is active and whether the printer is
locked from printing operations. When an e-stop is active, all print
commands are blocked until ``clear_emergency_stop()`` is called with an
acknowledgement note.
:param printer_name: Query a specific printer, or omit for all printers.
:param include_unlatched: When True, include printers that have no active
latch. Defaults to False (only active latches).
:returns: Latch state per printer: ``active`` (bool), ``reason``,
``source``, ``timestamp``, and whether critical interlocks prevent
clearing.
See also: ``emergency_stop()``, ``clear_emergency_stop()``.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| printer_name | No | ||
| include_unlatched | No |