home-assistant/core · error · ConfigEntryAuthFailed

Blink API authorization failed

Error message

Blink API authorization failed

What it means

ConfigEntryAuthFailed('Blink API authorization failed') raised in BlinkCoordinator._async_update_data when the forced refresh (api.refresh(force=True)) raises UnauthorizedError. This aborts the DataUpdateCoordinator update and moves the entry to reauth; a traceback in the logs is expected companion output.

Source

Thrown at homeassistant/components/blink/coordinator.py:67

        try:
            await self.api.start()
        except (ClientError, TimeoutError) as ex:
            raise ConfigEntryNotReady("Can not connect to host") from ex
        except (BlinkTwoFARequiredError, UnauthorizedError) as ex:
            raise ConfigEntryAuthFailed("Required Blink re-authentication") from ex
        except Exception as ex:
            raise ConfigEntryError("Unknown error connecting to Blink") from ex

        if not self.api.available:
            raise ConfigEntryNotReady

    @override
    async def _async_update_data(self) -> dict[str, Any]:
        """Async update wrapper."""
        try:
            return await self.api.refresh(force=True)
        except UnauthorizedError as ex:
            raise ConfigEntryAuthFailed("Blink API authorization failed") from ex

View on GitHub (pinned to 58a3fdb3ea)

Solutions

  1. Complete the reauth flow that appears for the Blink entry
  2. Avoid logging into the Blink app with account-linking prompts that reset tokens
  3. If it recurs every few hours, report it — refresh tokens should be renewed automatically by blinkpy
Defensive patterns

Strategy: try-catch

Try / catch

try:
    return await self.api.refresh(force=True)
except UnauthorizedError as ex:
    raise ConfigEntryAuthFailed("Blink API authorization failed") from ex

Prevention

When it happens

Trigger: Periodic coordinator update calls refresh(force=True); Blink answers 401 because the session/token expired since setup. Distinct from setup-time auth failure: this happens during steady-state polling.

Common situations: Blink invalidating long-lived tokens after days/weeks; account password change; concurrent logins causing token revocation; clock skew after HA host reboot.

Related errors

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