home-assistant/core · error · HomeAssistantError

The bond API returned an error calling set_power_state_belie

Error message

The bond API returned an error calling set_power_state_belief for {self.entity_id}.  Code: {ex.status}  Message: {ex.message}

What it means

Raised by BondFireplaceLight.async_set_power_belief when Action.set_power_state_belief(power_state) fails with a ClientResponseError. Used for fireplace on/off belief (including the brightness==0 → off path of async_set_brightness_belief).

Source

Thrown at homeassistant/components/bond/light.py:284

        try:
            await self._bond.action(
                self._device_id,
                Action.set_brightness_belief(round((brightness * 100) / 255)),
            )
        except ClientResponseError as ex:
            raise HomeAssistantError(
                "The bond API returned an error calling set_brightness_belief for"
                f" {self.entity_id}.  Code: {ex.status}  Message: {ex.message}"
            ) from ex

    async def async_set_power_belief(self, power_state: bool) -> None:
        """Set the belief state of the light."""
        try:
            await self._bond.action(
                self._device_id, Action.set_power_state_belief(power_state)
            )
        except ClientResponseError as ex:
            raise HomeAssistantError(
                "The bond API returned an error calling set_power_state_belief for"
                f" {self.entity_id}.  Code: {ex.status}  Message: {ex.message}"
            ) from ex

View on GitHub (pinned to 58a3fdb3ea)

Solutions

Match Code: 401 → re-auth; 404 → reload after re-adding; 5xx → retry.
Test the fireplace from the Bond app to rule out the device/hub side.
Keep the bond integration and hub firmware current.

Defensive patterns

Strategy: try-catch

Try / catch

try:
    await fireplace.async_set_power_belief(state)
except HomeAssistantError as err:
    if "Code: 401" in str(err): trigger_reauth()
    else: log_and_notify(err)

Prevention

Single re-auth after token rotation fixes all bond entities at once.
Avoid stacking many fireplace commands immediately after hub boot.

When it happens

Trigger: Turning the fireplace on/off (or brightness 0) while the Bond hub returns an HTTP error: 401 bad token, 404 unknown device_id, 5xx hub fault.

Common situations: Access token rotated without re-authenticating Home Assistant, device deleted from hub, hub recovering from a reboot.

Related errors

AI-assisted analysis of home-assistant/core@58a3fdb3ea (2026-08-14). Data as JSON: /api/errors/2106404c4659e074. Report an issue: GitHub.