Create or overwrite a scene config
automations_set_scene_configCreate or overwrite a Home Assistant scene's stored config with entity target states, then reload scenes so changes take effect. Use it to edit scene definitions, not to activate them.
Instructions
Create or overwrite a scene's stored config, then reload scenes.
Posts {id, name, entities} to /api/config/scene/config/<id>,
replacing any existing config at that id, then calls the
scene.reload service so the change takes effect immediately.
Not for: applying the scene's states right now — use
automations_activate_scene.
Returns: dict {"scene_id", "name", "entity_count", ...} merged with
HA's save response.
Errors: returns {"error": "entities must be a non-empty dict of {entity_id: state_dict}"} when entities is empty or not a dict.
Limits: no confirm parameter; an existing scene at scene_id is
replaced without a prompt.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Friendly name shown for the scene in the UI. | |
| entities | Yes | Non-empty mapping of entity_id to its target state dict for this scene, e.g. {'light.living_room': {'state': 'on', 'brightness': 76}}. Brightness is 0-255 (30% ~ 76, 50% ~ 128, 100% = 255). | |
| scene_id | Yes | Scene id to create or overwrite, bare (e.g. 'movie_night') or prefixed ('scene.movie_night'). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||