Recall Scene

philips_hue.recall_scene

ActionBusiness appsconnection required

Calls the Philips Hue API with the connection's credentials.

Apply a stored scene to the room or zone it belongs to.

Connection

Required: Yes — the node will not save without one
Auth type: API key
Providers: Philips Hue
Secret shape: {"api_key": "…"} (the bridge application key), plus "access_token" for Hue's remote gateway
Config it needs: base_url
Resolved by: config.connection_id, else node.connection_id

4 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

Field	Type	Required	Default	Constraints	Example
scene_id UUID of the scene to apply, as returned in the 'id' of a philips_hue.list_scenes row.	string	Yes	—	—	b7cbeb4d-e0c8-4f1e-9e0f-0a0f9d0b5f21
action How to apply the scene: 'active' plays it as stored, while 'dynamic_palette' and 'static' need the scene to carry a palette.	string	No	active	one of "active", "dynamic_palette", "static"	—
duration_ms How long the transition to the new state should take, in milliseconds. Left unset, the light changes at its default speed.	number	No	—	0–21600000	1000
brightness Overrides the scene's own brightness, as a percentage of each light's range. Left unset, the scene's stored levels are used.	number	No	—	0–100	60

Every value below is the contract’s own example or default — nothing invented.

{
  "action": "active",
  "brightness": 60,
  "duration_ms": 1000,
  "scene_id": "b7cbeb4d-e0c8-4f1e-9e0f-0a0f9d0b5f21"
}

One shape.

Field	Type	Example
updated The resource identifiers Hue reports it changed, each an object with a 'rid' and an 'rtype'.	array	—
count How many resources Hue reports it changed.	number	—

{
  "count": 0,
  "updated": []
}

In a technical demo we add the Philips Hue connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.