home-assistant/core · error · HomeAssistantError

Could not find To-do item

Error message

Could not find To-do item

What it means

HomeAssistantError raised in async_delete_todo_items when asyncio.gather over todo_by_uid lookups raises NotFoundError — at least one requested uid does not exist on the server. The whole delete operation aborts (the gather fails fast), so no items are removed.

Solutions

1. Refresh the entity's item list before issuing deletes so uids reflect server state
2. Delete items one-by-one (or re-select after refresh) so a single stale uid does not abort the batch
3. If writing automations, resolve uids dynamically from todo.get_items rather than hardcoding them

# Resolve uids fresh before a batch delete
items = await self.coordinator.async_get_items()  # or todo.get_items service
live_uids = {i.uid for i in items}
uids = [u for u in requested_uids if u in live_uids]

except NotFoundError as err:
    raise HomeAssistantError("Could not find To-do item") from err

When it happens

Trigger: Calling todo.remove_item / todo.set_value with uids where any one uid was already deleted server-side (multi-select delete after a stale UI list, or another client removed items concurrently).

Common situations: Stale to-do list in the HA UI after edits on phone/webmail; scripts deleting by hardcoded uid; server-side auto-clean of completed tasks.

Related errors

• Could not find To-do item
• CalDAV delete error
• CalDAV lookup error
• CalDAV save error
• CalDAV client error

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

Appendix: source

Thrown at homeassistant/components/caldav/todo.py:194

                ),
            )
            # refreshing async otherwise it would take too much time
            self.hass.async_create_task(self.async_update_ha_state(force_refresh=True))
        except (requests.ConnectionError, requests.Timeout, DAVError) as err:
            raise HomeAssistantError(f"CalDAV save error: {err}") from err

    @override
    async def async_delete_todo_items(self, uids: list[str]) -> None:
        """Delete To-do items."""
        tasks = (
            self.hass.async_add_executor_job(self._calendar.todo_by_uid, uid)
            for uid in uids
        )

        try:
            items = await asyncio.gather(*tasks)
        except NotFoundError as err:
            raise HomeAssistantError("Could not find To-do item") from err
        except (requests.ConnectionError, requests.Timeout, DAVError) as err:
            raise HomeAssistantError(f"CalDAV lookup error: {err}") from err

        # Run serially as some CalDAV servers do not support concurrent modifications
        for item in items:
            try:
                await self.hass.async_add_executor_job(item.delete)
            except (requests.ConnectionError, requests.Timeout, DAVError) as err:
                raise HomeAssistantError(f"CalDAV delete error: {err}") from err
        # refreshing async otherwise it would take too much time
        self.hass.async_create_task(self.async_update_ha_state(force_refresh=True))

View on GitHub (pinned to 58a3fdb3ea)