cancel_queued_jobs
Cancel all queued print jobs at once. Limit to a specific printer or preview changes with dry run. Only cancels jobs still in queue, not running prints.
Instructions
Cancel ALL queued print jobs at once.
The bulk companion to ``cancel_job`` (which cancels one job by id).
Cancels every job currently in the QUEUED state — clear a backed-up
queue in one call instead of cancelling one job at a time.
- ``printer_name``: limit the sweep to one printer's queued jobs; omit
to clear every queued job.
- ``dry_run=True``: preview exactly which jobs WOULD be cancelled and
change nothing. Run this first when clearing a large queue.
Safety: this never cancels a running print. Only jobs still in the
QUEUED state are cancelled; each job's status is re-checked immediately
before cancelling, so a job that has already started printing (or
finished, or was cancelled elsewhere) is skipped rather than
interrupted. Use ``cancel_print`` to stop the job that is actually
running. Each cancel emits the same ``JOB_CANCELLED`` event as
``cancel_job``.
Returns ``{success, dry_run, count, cancelled, skipped, message}`` —
``count`` always equals ``len(cancelled)``; ``skipped`` is a list of
``{job_id, reason}`` for jobs that were not cancelled.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | ||
| printer_name | No |