Delete a scene config
automations_delete_sceneDestructiveIdempotent
Delete a Home Assistant scene config by ID and reload scenes. Requires confirm=True; otherwise it returns a safety prompt and deletes nothing.
Instructions
Delete a scene config, then reload scenes.
Without confirm=True returns a safety prompt and touches nothing;
with confirm=True deletes /api/config/scene/config/<id> and calls
the scene.reload service.
Returns: dict {"deleted": sid, ...} merged with HA's delete response,
or {"status": "not_found", "scene_id": sid} when no scene has that
id.
Errors: returns {"error": "confirmation_required", "message": ..., "action": ...} when confirm is not True.
Limits: requires confirm=True; deletion is immediate and permanent.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | No | Must be True to actually delete the scene. False (default) returns a safety prompt instead of deleting anything. | |
| scene_id | Yes | Scene id to delete, bare (e.g. 'movie_night') or prefixed ('scene.movie_night'). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||