---
title: "Update a pronunciation dictionary"
method: PATCH
path: "/pronunciation_dicts/{id}"
tags: ["Pronunciation Dictionaries"]
---

# Update a pronunciation dictionary

`PATCH /pronunciation_dicts/{id}`

Update the name and/or items of an existing pronunciation dictionary. Uses optimistic locking — if the dictionary was modified concurrently, the request returns 409 Conflict.

## Path parameters

- `id` string, uuid, required

## Request body

- UpdatePronunciationDictRequest — Request body for updating a pronunciation dictionary. At least one field must be provided.
  - `name` string — Updated dictionary name.
  - `items` PronunciationDictItem[] — Updated list of pronunciation items (alias or phoneme type).
    - union — A single pronunciation dictionary item. Use type 'alias' to replace matched text with a spoken alias, or type 'phoneme' to specify exact pronunciation using IPA notation.
      - PronunciationDictAliasItem — An alias pronunciation item. When the `text` value is found in input, it is replaced with the `alias` before speech synthesis.
        - `text` string, required — The text to match in the input. Case-insensitive matching is used during synthesis.
        - `type` 'alias', required — The item type.
        - `alias` string, required — The replacement text that will be spoken instead.
      - PronunciationDictPhonemeItem — A phoneme pronunciation item. When the `text` value is found in input, it is pronounced using the specified IPA phoneme notation.
        - `text` string, required — The text to match in the input. Case-insensitive matching is used during synthesis.
        - `type` 'phoneme', required — The item type.
        - `phoneme` string, required — The phoneme notation representing the desired pronunciation.
        - `alphabet` 'ipa', required — The phonetic alphabet used for the phoneme notation.

## Response `200`

Pronunciation dictionary updated successfully.

- PronunciationDictResponse — Response containing a single pronunciation dictionary.
  - `data` PronunciationDictData — A pronunciation dictionary record.
    - `record_type` 'pronunciation_dict' — Identifies the resource type.
    - `id` string, uuid — Unique identifier for the pronunciation dictionary.
    - `name` string — Human-readable name for the dictionary. Must be unique within the organization.
    - `items` PronunciationDictItem[] — List of pronunciation items (alias or phoneme type).
      - union — A single pronunciation dictionary item. Use type 'alias' to replace matched text with a spoken alias, or type 'phoneme' to specify exact pronunciation using IPA notation.
        - PronunciationDictAliasItem — An alias pronunciation item. When the `text` value is found in input, it is replaced with the `alias` before speech synthesis.
          - `text` string, required — The text to match in the input. Case-insensitive matching is used during synthesis.
          - `type` 'alias', required — The item type.
          - `alias` string, required — The replacement text that will be spoken instead.
        - PronunciationDictPhonemeItem — A phoneme pronunciation item. When the `text` value is found in input, it is pronounced using the specified IPA phoneme notation.
          - `text` string, required — The text to match in the input. Case-insensitive matching is used during synthesis.
          - `type` 'phoneme', required — The item type.
          - `phoneme` string, required — The phoneme notation representing the desired pronunciation.
          - `alphabet` 'ipa', required — The phonetic alphabet used for the phoneme notation.
    - `version` integer — Auto-incrementing version number. Increases by 1 on each update. Used for optimistic concurrency control and cache invalidation.
    - `created_at` string, date-time — ISO 8601 timestamp with millisecond precision.
    - `updated_at` string, date-time — ISO 8601 timestamp with millisecond precision.

## Other responses

- `401` — Unauthorized. Invalid or missing API key.
- `404` — Pronunciation dictionary not found.
- `409` — Conflict. The dictionary was modified concurrently. Re-fetch and retry.
- `422` — Validation error.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)