Force refresh printer state

POST /v1/printers/reconcile-state

Force refresh printer state

Force a state refresh: re-check each printer's stored online and availability flags against its live state right now, instead of waiting for the periodic check. Only ever marks printers online or available; printers with a job in progress, in maintenance, or disabled are left as they are.

Requires: printer.control

Request Body

Printer IDs to refresh

BulkActionRequest

idsrequired

string[]

Example Request

application/json

{
  "ids": [
    "string"
  ]
}

Response Schema

ReconcilePrinterStateResult[]

Array of ReconcilePrinterStateResult, each with:

healedoptional

object

Set only for `healed`: which flags were turned on.

isAvailableoptional

boolean

isOnlineoptional

boolean

outcomerequired

"failed" | "skipped" | "healed" | "in-sync" | "no-live-state"

failedskippedhealedin-syncno-live-state

printerIdrequired

string

Example Response

201 OK — application/json

[
  {
    "printerId": "string",
    "outcome": "failed",
    "healed": {
      "isOnline": true,
      "isAvailable": true
    }
  }
]