---
title: "Update Camera Audio Status"
method: POST
path: "/cameras/v1/audio/status"
tags: ["Audio"]
---

# Update Camera Audio Status

`POST /cameras/v1/audio/status`

## Request

- Base URL: `https://api.verkada.com`
- URL: `https://api.verkada.com/cameras/v1/audio/status`
- Auth: one of:
  - API key in header `x-verkada-auth`
  - API key in header `x-api-key`

To use the Camera Audio API, you will need to generate an “Camera Audio” API key (separate from Read only and Read/write API keys). This doesn't work if Camera Audio is globally disabled (visit <a href="https://help.verkada.com/en/articles/6937133-feature-manager">Feature Manager</a>) or if audio is not supported by the camera model.


<b>Response Codes:</b>

<table>
<tr>
    <th>Response Code</th>
    <th>Message</th>
    <th>Troubleshooting Steps</th>
</tr>
<tr>
    <td>412</td>
    <td>Audio is not supported by the camera</td>
    <td>This camera model's hardware does not support audio.</td>
</tr>
<tr>
    <td>403</td>
    <td>Audio is not enabled for the organization</td>
    <td>Check your organization's Privacy and Security settings. If audio is not enabled in the <a href="https://help.verkada.com/en/articles/6937133-feature-manager">Feature Manager</a>, you will not be able to toggle the camera's audio status. </td>
</tr>
</table>

For standard HTTP response codes, refer to our <a href="/reference/request-methods">General Troubleshooting</a> page.

## Request body

- CameraAudioStatusPostRequest
  - `camera_id` string, required: The unique identifier of the camera.
  - `enabled` boolean, required: The status of audio for the camera. If value is True, audio is turned on for the camera.

## Response `200`

ok

---

[API](https://skmtc.dev/verkada/apis/camera-api.md) - [All operations](https://skmtc.dev/verkada/apis/camera-api/llms.txt) - [OpenAPI document](https://skmtc.dev/verkada/apis/camera-api/revisions/26cbfa5870e4?raw)