cancel_queued_jobs
Destructive
Cancel all queued print jobs in bulk, optionally limited to one printer, and use a dry-run preview to see which jobs would be cancelled without changing anything.
Instructions
Cancel ALL queued print jobs at once.
The bulk companion to ``cancel_queued_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_queued_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.
:param printer_name: Limit the sweep to one printer's queued jobs; omit to
clear every queued job.
:param dry_run: ``True`` previews exactly which jobs would be cancelled
and changes nothing. Run this first when clearing a large queue.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "cancel_queued_jobs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | ``True`` previews exactly which jobs would be cancelled and changes nothing. Run this first when clearing a large queue. Default: false. | |
| printer_name | No | Limit the sweep to one printer's queued jobs; omit to clear every queued job. |