---
title: "Update a voicemail playback"
method: PUT
path: "/voicemail_playbacks/{id}"
tags: ["Voicemail-Playbacks"]
---

# Update a voicemail playback

`PUT /voicemail_playbacks/{id}`

## Request

- Base URL: `https://api.commpeak.com/portal`
- URL: `https://api.commpeak.com/portal/voicemail_playbacks/{id}`
- Auth: API key in header `Authorization`

Updates a voicemail playback by its `id`; only the fields sent are changed. A new WAV file replaces the current one. `did_numbers`, `did_number_tags` and `send_to` replace the current lists when sent.

## Path parameters

- `id` integer, required: Voicemail playback identifier.

## Request body `multipart/form-data`

- object
  - `voicemail_playback[name]` string: Playback name (required on create).
  - `voicemail_playback[playback]` string, binary: WAV file (required on create; replaces the current file on update).
  - `voicemail_playback[send_to][]` string[]: Email addresses recorded voicemails are sent to.
  - `voicemail_playback[did_numbers][]` string[]: DID numbers (E.164) the playback is assigned to.
  - `voicemail_playback[did_number_tags][]` integer[]: DID tag ids the playback is assigned to.

## Response `200`

Successful Response

- VoicemailPlaybackResponse: Envelope returned by the single-playback methods.
  - `voicemail_playback` VoicemailPlaybackItem, required: A greeting played to callers before a voicemail is recorded on a DID number.
    - `id` integer, required: Playback identifier.
    - `name` string, nullable: Name.
    - `default` boolean, nullable: Whether this is the account default playback.
    - `send_to` string[], nullable: Email addresses recorded voicemails are sent to.
    - `did_numbers` string[], nullable: DID numbers the playback is assigned to.
    - `did_number_tags` DIDNumberTag[], nullable: DID tags the playback is assigned to.
      - `id` integer, required: DID tag identifier.
      - `name` string, nullable: DID tag name.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/commpeak/apis/commpeak-portal-api.md) - [All operations](https://skmtc.dev/commpeak/apis/commpeak-portal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commpeak/apis/commpeak-portal-api/revisions/df57b0c16367?raw)