From 6f0519ba66c2b9f508ae1cdb3d04582917da1390 Mon Sep 17 00:00:00 2001
From: epenet <6771947+epenet@users.noreply.github.com>
Date: Thu, 2 Sep 2021 21:23:55 +0200
Subject: [PATCH] Recommend ConfigEntryAuthFailed for reauthentication (#1048)

* raise ConfigEntryAuthFailed

* Update config_entries_config_flow_handler.md
---
 docs/config_entries_config_flow_handler.md | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)

diff --git a/docs/config_entries_config_flow_handler.md b/docs/config_entries_config_flow_handler.md
index 08d7c294..5e16e46d 100644
--- a/docs/config_entries_config_flow_handler.md
+++ b/docs/config_entries_config_flow_handler.md
@@ -241,15 +241,8 @@ async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry):
     auth = api.AsyncConfigEntryAuth(...)
     try:
         await auth.refresh_tokens()
-    except TokenExpiredError:
-        hass.async_create_task(
-            hass.config_entries.flow.async_init(
-                DOMAIN,
-                context={"source": SOURCE_REAUTH},
-                data=entry.data,
-            )
-        )
-        return False
+    except TokenExpiredError as err:
+        raise ConfigEntryAuthFailed(err) from err
 
     # TODO: Proceed with component setup
 ```