OpenPrinterOpenPrinter
OpenPrinter Agent Gateway

Agent sends heartbeat

Reply to each server.heartbeat by copying its messageId into correlationId. The uptime value is informational; the correlation is what proves that this connection is responsive.

Address

/.well-known/openprinter/gateway

Description

The authenticated, bidirectional OPPA gateway socket.

Messages

A correlated liveness response. The correlationId points to the server.heartbeat message being answered.

Payload

Message Example

{  "protocolVersion": "1",  "messageId": "heartbeat_response_01",  "sentAt": "2026-08-21T00:00:31Z",  "correlationId": "heartbeat_01",  "type": "agent.heartbeat",  "payload": {    "uptimeSeconds": 31  }}