From a8016530215af92e3e9bcb4eaf76f4511fa6c289 Mon Sep 17 00:00:00 2001 From: "J. Nick Koston" Date: Mon, 13 Jan 2025 00:52:12 -1000 Subject: [PATCH] Document async_remove_scanner Bluetooth API (#2527) --- docs/core/bluetooth/api.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/core/bluetooth/api.md b/docs/core/bluetooth/api.md index 1fb6e7f0..424fac0b 100644 --- a/docs/core/bluetooth/api.md +++ b/docs/core/bluetooth/api.md @@ -243,3 +243,13 @@ callback = bluetooth.async_get_advertisement_callback(hass) callback(BluetoothServiceInfoBleak(...)) ``` + +### Removing an external scanner + +To permanently remove an external scanner, call the `bluetooth.async_remove_scanner` API with the `source` (MAC address) of the scanner. This will remove any advertisement history associated with the scanner. + +```python +from homeassistant.components import bluetooth + +bluetooth.async_remove_scanner(hass, source) +```