---
title: "PATCH /pronunciation-dicts/{id}"
method: PATCH
path: "/pronunciation-dicts/{id}"
tags: ["PronunciationDicts"]
---

# PATCH /pronunciation-dicts/{id}

`PATCH /pronunciation-dicts/{id}`

Update a pronunciation dictionary

## Path parameters

- `id` string, required

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Request body

- UpdatePronunciationDictRequest — Request to update an existing pronunciation dictionary
  - `name` string — New name for the pronunciation dictionary
  - `description` string — New description for the pronunciation dictionary
  - `items` PronunciationDictItem[], nullable — Updated list of pronunciation mappings
    - `text` string, required — The original text to be replaced
    - `pronunciation` string, required — A phonetic representation or text to be said in place of the original text
    - `alias` string — Deprecated. Use `pronunciation` instead. This field is accepted in requests and may be returned for backwards compatibility.
  - `access` object — Change who can access the pronunciation dictionary
    - `type` 'private' | 'public', required — - `private`: only your organization can use the dictionary - `public`: anyone can use the dictionary

## Response `200`

- PronunciationDict — A dictionary of text-to-pronunciation mappings
  - `id` string, required — Unique identifier for the pronunciation dictionary
  - `name` string, required — Name of the pronunciation dictionary
  - `description` string, required — Description of the pronunciation dictionary
  - `is_owner` boolean, required — Whether your organization owns the pronunciation dictionary.
  - `access` object, required — Who can access the pronunciation dictionary
    - `type` 'private' | 'public', required — Who can use the pronunciation dictionary: - `private`: only your organization can use the dictionary - `public`: anyone can use the dictionary
    - `visibility` 'owner' | 'all', required — Who sees the pronunciation dictionary when using the [list endpoint](/api-reference/pronunciation-dicts/list): - `owner`: only your organization sees the dictionary listed - `all`: all users see the dictionary listed
  - `pinned` boolean, required — Whether this dictionary is pinned for the user
  - `items` PronunciationDictItem[], required — List of text-to-pronunciation mappings
    - `text` string, required — The original text to be replaced
    - `pronunciation` string, required — A phonetic representation or text to be said in place of the original text
    - `alias` string — Deprecated. Use `pronunciation` instead. This field is accepted in requests and may be returned for backwards compatibility.
  - `created_at` string, required — ISO 8601 timestamp of when the dictionary was created
  - `owner_id` string, required — ID of the user who owns this dictionary. Use `is_owner` instead.

---

[API](https://skmtc.net/cartesia/apis/cartesia-api.md) · [All operations](https://skmtc.net/cartesia/apis/cartesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cartesia/cartesia-api/versions/8910812440d3/schema)