home-assistant/core · error · HomeAssistantError

Failed to set {self.entity_id} params: {error}

Error message

Failed to set {self.entity_id} params: {error}

What it means

HomeAssistantError from AirzoneAidooEntity._async_update_params when api_set_aidoo_id_params() fails with AirzoneCloudError. Aidoo devices are add-on modules bridging third-party AC units to Airzone Cloud; this write path backs their climate/number/select services, with entity_id and cloud error in the message.

Source

Thrown at homeassistant/components/airzone_cloud/entity.py:100

    @override
    def get_airzone_value(self, key: str) -> Any:
        """Return Aidoo value by key."""
        value = None
        if aidoo := self.coordinator.data[AZD_AIDOOS].get(self.aidoo_id):
            value = aidoo.get(key)
        return value

    @override
    async def _async_update_params(self, params: dict[str, Any]) -> None:
        """Send Aidoo parameters to Cloud API."""
        _LOGGER.debug("aidoo=%s: update_params=%s", self.entity_id, params)
        try:
            await self.coordinator.airzone.api_set_aidoo_id_params(
                self.aidoo_id, params
            )
        except AirzoneCloudError as error:
            raise HomeAssistantError(
                f"Failed to set {self.entity_id} params: {error}"
            ) from error

        self.coordinator.async_set_updated_data(self.coordinator.airzone.data())


class AirzoneGroupEntity(AirzoneEntity):
    """Define an Airzone Cloud Group entity."""

    def __init__(
        self,
        coordinator: AirzoneUpdateCoordinator,
        group_id: str,
        group_data: dict[str, Any],
    ) -> None:
        """Initialize."""
        super().__init__(coordinator)

View on GitHub (pinned to 58a3fdb3ea)

Solutions

1. Open the Airzone Cloud app and confirm the Aidoo still exists and accepts the same change.
2. Retry after the cloud service recovers; check the embedded {error} text.
3. If the device was removed, delete the stale entity / reload the integration.
4. Throttle automations to avoid hammering the cloud write API.

try:
    await entity._async_update_params(params)
except HomeAssistantError as err:
    _LOGGER.error("Aidoo write failed: %s", err)

When it happens

Trigger: Any service call that writes Aidoo parameters (mode, setpoint, fan speed) while the Cloud API errors: outage, rate limit, expired token, or device id no longer present in the installation.

Common situations: Aidoo unlinked from the cloud account (entity stale); cloud outage mid-automation; rapid successive writes hitting cloud rate limits.

Related errors

• {error}
• Can't allow access from Home Assistant Cloud
• Failed to set system {self.entity_id}: {error}
• Failed to set DHW: {error}
• Failed to set zone {self.entity_id}: {error}

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