---
title: "PATCH /speakers/{speakerId}/settings"
method: PATCH
path: "/speakers/{speakerId}/settings"
tags: ["Speakers"]
---

# PATCH /speakers/{speakerId}/settings

`PATCH /speakers/{speakerId}/settings`

Updates the settings of a speaker.

## Request body

- AdvancedSettings
  - `data` Settings1, required
    - `protocol` string — Specifies the audio communication protocol.
    - `audioMode` 'disabled' | 'talkDown' | 'twoWayAudio' — Specifies mode of audio communication.
    - `sipCredentials` object — The credentials that will be used to authenticate SIP sessions.
      - `username` string — Username to use when authenticating with the device
      - `password` string — Password to use when authenticating with the device
    - `mainCredentials` object — The credentials that will be used for communicating with the devices. These credentials should be for the main API of the device, which generally is its ONVIF API.
      - `username` string — Username to use when authenticating with the device
      - `password` string — Password to use when authenticating with the device
  - `schema` AdvancedSettingsSchema — Json schema of version draft 4.

## Response `204`

Speaker Updated

## Other responses

- `400` — The supplied object is invalid. Error detail will contain the validation error.
- `401` — You are not authenticated. Please authenticate and try again.
- `403` — You have no permission to access the specified resource.
- `404` — Referenced resource could not be found.
- `500` — Something went wrong in the server. Please try again.

---

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