v24

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-017946115.2 KB

Refresh Relay

Force the central signaling relay to reconnect — see notify_force_reconnect.

Response shapes:

  • {"status": "requested", "token_available": bool} — a reconnect was kicked off.
  • {"status": "skipped", "token_available": bool, "reason": "relay_not_running" | "relay_unavailable"} — no reconnect happened. The mobile app's auto-heal loop must NOT wait for a state change in this case (it would hang forever). relay_unavailable covers the import failure (Lite-only build that ships no relay module); relay_not_running covers the module-present-but-no-instance case (daemon started without a token / pre-init / shutdown).
post/api/hf-auth/refresh-relay

Response

Successful Response

object required