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
any

Example Response

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