home-assistant/core · error · ConfigEntryAuthFailed

err

Error message

err

What it means

ConfigEntryAuthFailed(err) raised by the autarco coordinator when the autarco library raises AutarcoAuthenticationError during any of the site/solar/inverters/battery fetches. This tells Home Assistant the API key/email pair is invalid or revoked, so the entry enters reauth state (setup error with a Reauthenticate prompt) instead of retrying.

Source

Thrown at homeassistant/components/autarco/coordinator.py:69

            config_entry=config_entry,
            name=DOMAIN,
            update_interval=SCAN_INTERVAL,
        )
        self.client = client
        self.account_site = account_site

    @override
    async def _async_update_data(self) -> AutarcoData:
        """Fetch data from Autarco API."""
        battery = None
        try:
            site = await self.client.get_site(self.account_site.public_key)
            solar = await self.client.get_solar(self.account_site.public_key)
            inverters = await self.client.get_inverters(self.account_site.public_key)
            if site.has_battery:
                battery = await self.client.get_battery(self.account_site.public_key)
        except AutarcoAuthenticationError as err:
            raise ConfigEntryAuthFailed(err) from err
        except AutarcoConnectionError as err:
            raise UpdateFailed(err) from err
        return AutarcoData(
            solar=solar,
            inverters=inverters,
            site=site,
            battery=battery,
        )

View on GitHub (pinned to 58a3fdb3ea)

Solutions

  1. Open Settings > Devices & Services > Autarco > Reauthenticate and re-enter the current email/API key
  2. Verify the key works by calling the Autarco API manually with the same credentials
  3. Confirm the site public key still belongs to this account in the Autarco app
Defensive patterns

Strategy: validation

Try / catch

try:
    await coordinator.async_config_entry_first_refresh()
except ConfigEntryAuthFailed:
    # push the user to the reauth flow immediately
    entry.async_start_reauth(hass)

Prevention

When it happens

Trigger: autarco client calls returning 401/403: wrong API key or email in the config entry, key regenerated in the Autarco dashboard, account password changed, subscription lapsing.

Common situations: User regenerated the Autarco API key without updating HA; typo in credentials at setup; account access ended (system removed from account).

Related errors

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