Sonos version 9.3 API update

In Sonos version 9.3, we added subscribe and unsubscribe commands to the audioClip namespace and made some updates. We also added a settings namespace. See Release notes for Sonos software for customer-facing features.

Audio clip

We made the following updates:

Note: This namespace is experimental. Some of the functionality may not yet work as documented. For example, the AUDIO_CLIP capability in the player object has not yet been released, so you won’t be able to tell which players support audio clips and which do not. Currently, the only players that support audio clips are the Sonos One and the Beam. See the groups object for details about capabilities.

We’ll let you know when we’ve added more functionality. Keep an eye on this blog for details.


You can use the setPlayerSettings command to change playerSettings. For example:

  • Change the volumeMode to PASS_THROUGH a Sonos device such as the Amp or Connect.
  • Change the volumeScalingFactor to limit the maximum volume for Sonos players.
  • Turn on monoMode for a pair of Sonos players.
  • Disable WiFi on a Sonos player (wifiDisable).

Soon you will be able to use getPlayerSettings to see the current values for these settings. Watch this space for an update on when you can use this command.

We hope you enjoy these changes and look forward to seeing what you build with them!