---
title: "setOptions"
method: POST
path: "/players/{playerId}/homeTheater/options"
tags: ["homeTheater"]
---

# setOptions

`POST /players/{playerId}/homeTheater/options`

This command is used to customize the home theater experience. The client application
 can send multiple options to the player concurrently. The player will only change the
 values of those options which are present.

 Note: This is a subset of homeTheater options that are being exposed for guest access.

## Request body

- object
  - `nightMode` boolean, nullable — *Night Sound* is most useful when watching TV at low volumes, such as late at night. It will make the dialogue more clear, while reducing the intensity of loud sounds.
  - `enhanceDialog` boolean, nullable — *Speech Enhancement* boosts the audio frequencies associated with the human voice. Turning this feature on will make dialogue easier to hear, which can be especially useful during action movies.

## Response `200`

See the x-muse-error-codes extension for a list of muse errors that generate this response

- HomeTheaterOptions — These settings are specific to the home theater feature on some products.
  - `nightMode` boolean, nullable — *Night Sound* is most useful when watching TV at low volumes, such as late at night. It will make the dialogue more clear, while reducing the intensity of loud sounds.
  - `enhanceDialog` boolean, nullable — *Speech Enhancement* boosts the audio frequencies associated with the human voice. Turning this feature on will make dialogue easier to hear, which can be especially useful during action movies.

## Other responses

- `400` — See the x-muse-error-codes extension for a list of muse errors that generate this response
- `401` — See the x-muse-error-codes extension for a list of muse errors that generate this response
- `403` — See the x-muse-error-codes extension for a list of muse errors that generate this response
- `404` — See the x-muse-error-codes extension for a list of muse errors that generate this response
- `499` — See the x-muse-error-codes extension for a list of muse errors that generate this response
- `500` — See the x-muse-error-codes extension for a list of muse errors that generate this response
- `503` — See the x-muse-error-codes extension for a list of muse errors that generate this response

---

[API](https://skmtc.net/sonos/apis/authorization-api.md) · [All operations](https://skmtc.net/sonos/apis/authorization-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sonos/authorization-api/revisions/243132628620/schema)
