---
title: "Refresh Relay"
method: POST
path: "/api/hf-auth/refresh-relay"
---

# Refresh Relay

`POST /api/hf-auth/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).

## Response `200`

Successful Response

- object

---

[API](https://skmtc.net/pollen-robotics/apis/reachy-mini-rest-api.md) · [All operations](https://skmtc.net/pollen-robotics/apis/reachy-mini-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pollen-robotics/reachy-mini-rest-api/versions/9843f2902e88/schema)