OpenPrinterOpenPrinter Agent Gateway
Agent sends printer inventory
The agent sends a complete snapshot after the handshake and whenever a
full refresh is needed. revision increases with the agent's local
inventory state. Include correlationId when this snapshot answers
server.request_printer_inventory.
Address
/.well-known/openprinter/gatewayDescription
The authenticated, bidirectional OPPA gateway socket.
Messages
A complete snapshot of the printers currently visible to the agent. The optional correlation ID is used when the snapshot answers a server inventory request.
Payload
Message Example
{ "protocolVersion": "1", "messageId": "inventory_01", "sentAt": "2026-08-21T00:00:02Z", "correlationId": "inventory_request_01", "type": "agent.printer_inventory", "payload": { "revision": 7, "printers": [ { "id": "printer_01", "fingerprint": "usb:printer_01", "name": "Receipt printer", "kind": "local", "enabled": true, "availability": "online", "capabilities": { "mediaWidths": [ 80 ], "raster": true, "cut": true, "qr": true, "barcode": true }, "connection": { "type": "system", "systemName": "/dev/usb/lp0" } } ] }}