Skip to main content

Pairing Flow

The pairing flow connects a physical display device to a specific room in SpaceOS.

Flow Diagram​

Authentication​

After pairing, the display uses its device JWT for all API calls and WebSocket connections:

  • JWT is stored securely on the device
  • Token includes: device ID, physical space ID, organization ID
  • WebSocket connections authenticate via token in handshake

Auto-Reconnection​

Displays handle connection drops automatically:

  • WebSocket disconnects trigger reconnection with exponential backoff
  • Device JWT is re-validated on reconnect
  • Room status is refreshed after reconnection

Next Steps​