Skip to content

Set volume on Scout

Module · Stable

Set the output volume on a paired Scout device (fire-and-forget).

Sends a ‘set_volume’ command to a Scout physical device, changing its audio output level. The device must be paired and have ‘set_volume’ in its capabilities. volume is a 0..1 fraction (0 mutes, 1 is maximum) — the same scale the device reports its current volume on in health, so a flow can read {{ health.volume }}, adjust it, and feed it back. When device_id is omitted the step auto-selects the first available device. Returns enqueued=True and the command identifiers on success, or enqueued=False with an error string on failure (no device, bad volume).

Use to make sure a Scout will actually be heard before it speaks: when a device reports audible=false or a low volume, add this step before a Scout Speak to raise the level, or lower it during quiet hours. Pair with Branch on enqueued to handle the ‘no device available’ case.

Do not use to play audio or speak — that’s Scout Speak. This only changes the volume level; it sends no sound of its own. To mute a browser or phone notification, use Send Notification settings instead. If no Scout device with ‘set_volume’ capability is paired, this step returns enqueued=False (it does not raise).

Configured per use: volume, device_id.

  • command_id
  • correlation_id
  • device_id
  • enqueued

Auto-generated from the skill registry (load_skills()). Do not edit by hand.