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.

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.

Appendix: 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)