Forget

Forget the currently connected network and drop the connection.

Must never be reachable anonymously -- unlike the rest of this router, this route adds :func:~palmimo_portal.api.deps.require_provisioned and :func:~palmimo_portal.api.deps.require_auth explicitly on top of the router's own require_wifi_access + require_full_session. Unlike POST /wifi/connect, does not write a last_wifi_attempt record -- forgetting is not a connect attempt.

Raises: PortalError: 503 network_backend_unavailable if network.forget_current raises :class:~palmimo_portal.ports.AdapterUnavailableError -- translated by the app-wide exception handler in :mod:palmimo_portal.api.app. 409 wifi_not_connected if it raises :class:~palmimo_portal.ports.NotConnectedError -- the adapter's own fresh state read (never this endpoint's status above, which can already be stale) found the device not actually CONNECTED. 502 wifi_forget_failed for any other exception.