ai_licia Public API
Public API Overview
Local WebSocket

Local WebSocket

The desktop dashboard app exposes a local-only WebSocket for third-party integrations (for example, Lumia). It lets your app request user approval and receive the channel API key that works with the REST API.

Key facts:

  • URL: ws://127.0.0.1:51743 (override with INTEGRATION_WS_PORT)
  • Transport: JSON messages with {type, payload}
  • Authorization: explicit user consent; revoke by regenerating the API key
  • Local only: the server binds to 127.0.0.1

Quick links:

Getting Started
Connect and request access
Message Reference
Handshake and auth messages
Capability: Events
TTS amplitude stream
Capability: State
Reserved for future state snapshots
Capability: integration.auth
Consent + API key flow

AuthenticationGetting Started