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/gatewayDescription
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 } }}