{"record":{"id":"c1bea18a73c815fc","repo":"home-assistant/core","slug":"bridge-unreachable","errorCode":"BRIDGE_UNREACHABLE","errorMessage":"Alexa API not enabled in Home Assistant configuration","messagePattern":"Alexa API not enabled in Home Assistant configuration","errorType":"exception","errorClass":"AlexaBridgeUnreachableError","httpStatus":null,"severity":"error","filePath":"homeassistant/components/alexa/smart_home.py","lineNumber":207,"sourceCode":"    context: Context | None = None,\n    enabled: bool = True,\n) -> dict[str, Any]:\n    \"\"\"Handle incoming API messages.\n\n    If enabled is False, the response to all messages will be a\n    BRIDGE_UNREACHABLE error. This can be used if the API has been disabled in\n    configuration.\n    \"\"\"\n    assert request[API_DIRECTIVE][API_HEADER][\"payloadVersion\"] == \"3\"\n\n    if context is None:\n        context = Context()\n\n    directive = AlexaDirective(request)\n\n    try:\n        if not enabled:\n            raise AlexaBridgeUnreachableError(  # noqa: TRY301\n                \"Alexa API not enabled in Home Assistant configuration\"\n            )\n\n        await config.set_authorized(True)\n\n        if directive.has_endpoint:\n            directive.load_entity(hass, config)\n\n        funct_ref = HANDLERS.get((directive.namespace, directive.name))\n        if funct_ref:\n            response = await funct_ref(hass, config, directive, context)\n            if directive.has_endpoint:\n                response.merge_context_properties(directive.endpoint)\n        else:\n            _LOGGER.warning(\n                \"Unsupported API request %s/%s\", directive.namespace, directive.name\n            )\n            response = directive.error()","sourceCodeStart":189,"sourceCodeEnd":225,"githubUrl":"https://github.com/home-assistant/core/blob/58a3fdb3ea0538617f0a07efcfba6294de64fd59/homeassistant/components/alexa/smart_home.py#L189-L225","documentation":"Raised in smart_home.py's async_handle_message when the enabled flag is false: the Alexa smart_home API endpoint was disabled in configuration (smart_home: enable: false under the cloud integration), so every directive gets a BRIDGE_UNREACHABLE response naming the disabled API.","triggerScenarios":"Any Alexa smart home directive while configuration.yaml contains cloud: smart_home: enable: false (or the setting was toggled off), including state reports and discovery.","commonSituations":"Users disable the Alexa API to troubleshoot, then forget to re-enable; YAML indentation errors leave enable false; remote UI toggle turned it off.","solutions":["Set enable: true (or remove the smart_home block) in configuration.yaml and restart Home Assistant","Check Settings -> Cloud -> Alexa to confirm the API is active","Verify YAML indentation of the cloud: smart_home: section after edits"],"exampleFix":"# configuration.yaml\n# before\ncloud:\n  smart_home:\n    enable: false\n\n# after\ncloud:\n  smart_home:\n    enable: true","handlingStrategy":"validation","validationCode":"if not config.should_expose(entity_id):  # proxy for cloud config presence\n    _LOGGER.warning('Entity not exposed to Alexa')","typeGuard":null,"tryCatchPattern":"Catch AlexaBridgeUnreachableError / detect BRIDGE_UNREACHABLE in responses and alert the user the smart home API is disabled in configuration.","preventionTips":["Keep cloud.smart_home.enable true in configuration.yaml","Check Settings -> Cloud -> Alexa after troubleshooting changes","Validate YAML indentation after edits"],"tags":["alexa","smart-home","configuration","cloud"],"backgroundTag":null,"analyzedSha":"58a3fdb3ea0538617f0a07efcfba6294de64fd59","analyzedAt":"2026-08-14T20:54:38.818Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}