Skip to main content

Display Provisioning

Meeting room displays are provisioned through ZenEdge using a magic link pairing flow.

Pairing Flow​

  1. Register display — Create a display entry in ZenEdge
  2. Generate pairing code — Get a QR code or OTP for the device
  3. Enter on device — The display device (Android kiosk or web app) enters the pairing code
  4. Authenticate — ZenEdge issues a device JWT for the display
  5. Connect — Display connects to the Realtime Service via WebSocket
  6. Sync — Display receives room status, booking schedule, and device events in real-time

Display Registration​

POST /api/v1/displays
x-api-key: <api-key>
Content-Type: application/json

{
  "physical_space_id": "ps-xyz789",
  "name": "Room 101 Display"
}

Supported Display Hardware​

PlatformApplication
Webzs-meeting-room-display (React + Vite + Socket.IO)
AndroidZenspaceMeetingDisplay (Java, kiosk mode, SDK 24+)
Any browserWorks on any device with a modern browser

Display Configuration​

Once paired, displays can be configured for:

  • Room assignment
  • Branding (logo, colors)
  • Display layout
  • QR code scanning for quick booking
  • Kiosk mode (locked-down, no user navigation)

Backend Endpoints​

EndpointDescription
POST /api/v1/displaysRegister new display
GET /api/v1/displays/:idGet display details
POST /api/v1/displays/:id/pairGenerate pairing code
POST /api/v1/displays/verifyVerify pairing code and issue device JWT

Next Steps​