OpenPrinterOpenPrinter
OpenPrinter Agent Gateway

Agent reports failure

Send a bounded, sanitized error when the agent cannot complete delivery or submission. retryable tells the server whether another delivery attempt may be useful; do not include credentials or the full document.

Address

/.well-known/openprinter/gateway

Description

The authenticated, bidirectional OPPA gateway socket.

Messages

A bounded failure report for a job that could not be completed. The server can use retryable to decide whether to schedule another delivery attempt.

Payload

Message Example

{  "protocolVersion": "1",  "messageId": "job_failed_01",  "sentAt": "2026-08-21T00:00:06Z",  "correlationId": "job_delivery_01",  "type": "agent.job_failed",  "payload": {    "jobId": "job_01",    "idempotencyKey": "order_123_receipt_v1",    "status": "failed",    "failedAt": "2026-08-21T00:00:06Z",    "error": {      "code": "printer_offline",      "message": "The selected printer is offline.",      "retryable": true    }  }}