OpenPrinterOpenPrinter
OpenPrinter Agent Gateway

Server disconnects

The server sends this frame before an intentional close. reconnect states whether the agent should reconnect, while retryAfterMs can provide a lower-bound delay for the next attempt.

Address

/.well-known/openprinter/gateway

Description

The authenticated, bidirectional OPPA gateway socket.

Messages

A final application frame before an intentional server close. The reconnect flag and optional delay give the agent the host's reconnect policy without exposing implementation details.

Payload

Message Example

{  "protocolVersion": "1",  "messageId": "disconnect_01",  "sentAt": "2026-08-21T00:03:00Z",  "type": "server.disconnect",  "payload": {    "code": "server_maintenance",    "reason": "The gateway is restarting for maintenance.",    "reconnect": true,    "retryAfterMs": 5000  }}