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
- Follow the reauthentication prompt in Settings > Devices & Services and re-enter credentials
- Verify the credentials work in the vendor app first
- If reauth repeatedly fails immediately, remove and re-add the integration
- 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
- Keep Airobot credentials stable; password changes require reauth
- Complete the reauth prompt promptly — entities stay unavailable until done
- Verify login works in the vendor app before re-authenticating in HA
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
- Authentication and authorization failures — expired tokens, bad credentials, and missing scopes.
Related errors
- Unable to deactivate the owner
- invalid_api_key
- authentication_failed
- setup_authentication_exception
- coordinator_auth_error
AI-assisted analysis of home-assistant/core@58a3fdb3ea (2026-08-14).
Data as JSON: /api/errors/af23687b4fda88a5.
Report an issue: GitHub.