curl --request PATCH \
--url https://tavusapi.com/v2/pronunciation-dictionaries/{dictionary_id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
[
{
"op": "replace",
"path": "/name",
"value": "Updated Brand Terms"
}
]
'{
"pronunciation_dictionary_id": "pd_abc123def456gh",
"name": "Updated Brand Terms",
"rules": [
{
"text": "Tavus",
"pronunciation": "TAH-vus",
"type": "alias",
"case_sensitive": false,
"word_boundaries": true
}
],
"rules_count": 1,
"created_at": "2025-01-15T10:30:00Z",
"updated_at": "2025-01-15T12:00:00Z"
}{
"error": "Invalid request: duplicate text values in rules"
}{
"message": "Invalid access token"
}{
"message": "Pronunciation dictionary not found"
}{
"message": "Invalid JSON patch format"
}Pronunciation Dictionaries
Update Pronunciation Dictionary
Update a pronunciation dictionary’s name or rules using JSON Patch format (RFC 6902). Supported mutable fields are name and rules.
PATCH
/
v2
/
pronunciation-dictionaries
/
{dictionary_id}
curl --request PATCH \
--url https://tavusapi.com/v2/pronunciation-dictionaries/{dictionary_id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
[
{
"op": "replace",
"path": "/name",
"value": "Updated Brand Terms"
}
]
'{
"pronunciation_dictionary_id": "pd_abc123def456gh",
"name": "Updated Brand Terms",
"rules": [
{
"text": "Tavus",
"pronunciation": "TAH-vus",
"type": "alias",
"case_sensitive": false,
"word_boundaries": true
}
],
"rules_count": 1,
"created_at": "2025-01-15T10:30:00Z",
"updated_at": "2025-01-15T12:00:00Z"
}{
"error": "Invalid request: duplicate text values in rules"
}{
"message": "Invalid access token"
}{
"message": "Pronunciation dictionary not found"
}{
"message": "Invalid JSON patch format"
}For AI agents, use
https://docs.tavus.io/openapi.yaml for the full HTTP API contract.Body
application/json
Read-only fields like pronunciation_dictionary_id, created_at, and updated_at are silently ignored. If all operations target read-only fields or result in no changes, the endpoint returns 304.
When rules are updated, all PALs referencing this dictionary are automatically updated with the new provider-specific pronunciation data.
Note: Updating rules replaces the entire rules array. There is no way to add or remove individual rules - provide the complete updated list.
For example:
[
{ "op": "replace", "path": "/name", "value": "Updated Brand Terms" },
{ "op": "replace", "path": "/rules", "value": [
{ "text": "Tavus", "pronunciation": "TAH-vus", "type": "alias" }
]}
]
Response
Pronunciation dictionary updated successfully

