home-assistant/core · critical · ConfigEntryAuthFailed

Authentication failed, please reauthenticate.

Error message

Authentication failed, please reauthenticate.

What it means

Raised by the Airobot coordinator when get_statuses()/get_settings() fail with AirobotAuthError. ConfigEntryAuthFailed with translation key authentication_failed starts the reauthentication flow for the config entry: entities go unavailable and HA prompts the user to log in again.

Source

Thrown at homeassistant/components/airobot/coordinator.py:61

        session = async_get_clientsession(hass)

        self.client = AirobotClient(
            host=entry.data[CONF_HOST],
            username=entry.data[CONF_USERNAME],
            password=entry.data[CONF_PASSWORD],
            session=session,
        )

    @override
    async def _async_update_data(self) -> AirobotData:
        """Fetch data from API endpoint."""
        try:
            status, settings = await asyncio.gather(
                self.client.get_statuses(),
                self.client.get_settings(),
            )
        except AirobotAuthError as err:
            raise ConfigEntryAuthFailed(
                translation_domain=DOMAIN,
                translation_key="authentication_failed",
            ) from err
        except AirobotConnectionError as err:
            raise UpdateFailed(
                translation_domain=DOMAIN,
                translation_key="connection_failed",
            ) from err

        return AirobotData(status=status, settings=settings)

View on GitHub (pinned to 58a3fdb3ea)

Solutions

  1. Follow the reauthentication prompt in Settings > Devices & Services and re-enter credentials
  2. Verify the credentials work in the vendor app first
  3. If reauth repeatedly fails immediately, remove and re-add the integration
  4. Check for Airobot cloud-side auth outages before re-adding
Defensive patterns

Strategy: try-catch

Try / catch

# Custom integrations calling Airobot-like coordinators:
try:
    data = await coordinator.async_data()
except ConfigEntryAuthFailed:
    # trigger reauth flow / notify user; do not retry with the same credentials

Prevention

When it happens

Trigger: The stored Airobot credentials/token are rejected by the cloud API — expired token, password changed, account logged out elsewhere, or revoked session.

Common situations: User changed their Airobot account password, token TTL expired, or the integration's stored session was invalidated server-side.

Understand the failure class

Related errors


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