Remove entity from registry
entities_remove_entityRemove an orphaned entity's registry entry when no loaded integration provides it. Refuses entries an integration still supplies unless forced, preventing recreation.
Instructions
Remove an entity's entry from the entity registry, refusing one an integration still provides.
Reads the entry (config/entity_registry/get) and the entity's state.
An entity counts as still provided when it has a state that is not a
restored placeholder (attributes.restored, which HA sets for entities
no loaded integration provides). Such an entity is refused unless
force, because its integration re-creates the entry at the next
reload. Otherwise sends config/entity_registry/remove; its customised
name, area, labels and entity_id are lost.
Use when: cleaning up orphaned entities ("no longer provided").
Not for: hiding a working entity — use entities_disable_entity;
removing a device with its entities — use devices_remove_device.
Returns: {"removed": true, "entity_id", "platform", "was_provided"}.
Errors: invalid_entity_id (no I/O), not_found,
entity_still_provided (nothing removed), state_check_failed,
ws_error with Home Assistant's code/message.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"entity_id": "<entity_id>"
},
"name": "entities_remove_entity"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | True removes the entry even while an integration still provides the entity (it comes back). | |
| entity_id | Yes | Full entity ID to remove from the registry, e.g. 'sensor.old_plug_power'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||