OpenPrinterOpenPrinter
OpenPrinter Agent Gateway

Agent sends hello

This is the first application message on every authenticated connection. The agentId must match the identity proven during authentication. A server selects one shared protocol version in server.hello.

Address

/.well-known/openprinter/gateway

Description

The authenticated, bidirectional OPPA gateway socket.

Messages

The first application message on every authenticated connection. It identifies the running product and advertises the protocol versions the agent can speak.

Payload

Message Example

{  "protocolVersion": "1",  "messageId": "message_hello_01",  "sentAt": "2026-08-21T00:00:01Z",  "type": "agent.hello",  "payload": {    "agentId": "agent_01",    "agentVersion": "0.1.0",    "productId": "oppa",    "productVersion": "0.1.0",    "supportedProtocolVersions": [      "1"    ]  }}