Printago API
POST /v1/print-jobs/queue/run

Run the queue matcher now

Run the queue matcher synchronously, bypassing the per-store "Automatic Queue Matching" gate. Use this for an explicit "match the queue right now" action (e.g. after staging printer/material changes with auto matching turned off). Returns the resulting (printer, job) pairs so the caller can render them or fold them into a future dry-run/preview UI.

Requires: queue.manage

Response Schema

RunQueueResponse
assignmentsrequired
object[]
jobLabelrequired
string
printerIdrequired
string
pattern: ^[a-z0-9]{24}$
printJobIdrequired
string
pattern: ^[a-z0-9]{24}$
skippedoptional
"no-printers" | "no-jobs" | "no-subscription-slots" | "auto-matching-disabled"
no-printersno-jobsno-subscription-slotsauto-matching-disabled

Example Response

201 OK — application/json 
{
  "skipped": "no-printers",
  "assignments": [
    {
      "printerId": "string",
      "printJobId": "string",
      "jobLabel": "string"
    }
  ]
}