Delete category
labels_delete_categoryDelete a category from a registry scope in Home Assistant by scope and category ID. Use when a category is no longer needed within its scope.
Instructions
Delete a category from a registry scope.
Calls WS config/category_registry/delete with scope and
category_id and returns Home Assistant's result unchanged.
Use when: a category is no longer needed within its scope.
Returns: dict with scope, category_id, the raw WS result, and
ok.
Errors: on a WS failure, returns {"scope": ..., "category_id": ..., "ok": false, "error": "<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": {
"scope": "<scope>",
"category_id": "<category_id>"
},
"name": "labels_delete_category"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | Yes | Registry scope the category belongs to, e.g. 'automation'. | |
| category_id | Yes | Category registry ID to delete; obtain it from labels_list_categories. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||