---
title: "Update a shared voicemail"
method: POST
path: "/shared_voicemails/{id}"
tags: ["Shared Voicemail"]
---

# Update a shared voicemail

`POST /shared_voicemails/{id}`

Update a shared voicemail

## Path parameters

- `id` string, required — The unique ID of the resource.

## Request body

- object
  - `name` string — The name of shared voicemail.
  - `prompt` string — BCP 47 Language Tags (The Internet Best Current Practices (BCP) for language tags). A language tag is composed of a sequence of one or more subtags such as language, region, variant and script subtags. When a language tag is comprised of more than one subtag, the subtag values are separated by the "-" character. You will most commonly find language tags written with 2 subtags - language and region. For example: en-US.
  - `enable_pin` boolean — Whether the PIN is required to access shared voicemail.
  - `pin` string — The PIN number for accessing. The PIN policies include: 1. A sequence of numbers 6-10 digits in length. 2. No repeating numbers (e.g. "111", "222") 3. No sequential numbers (e.g. "012", "789")
  - `enable_email_notify` boolean — Enable email notify or not.
  - `recipients` string — Comma-separated list of email address that should receive notifications. Allow up to 15 email addresses.
  - `play_datetime` 'DISABLE' | '12_HOUR_CLOCK' | '24_HOUR_CLOCK' — Announces Date and Time of Message. - `DISABLE`: Do not read; - `12_HOUR_CLOCK`: Read in 12-hour clock; - `24_HOUR_CLOCK`: Read in 24-hour clock.

## Response `200`

OK

## Other responses

- `4XX` — Error

---

[API](https://skmtc.net/portsip/apis/portsip-pbx-rest-api.md) · [All operations](https://skmtc.net/portsip/apis/portsip-pbx-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/portsip/portsip-pbx-rest-api/revisions/577415d4a3d5/schema)