curl -X PATCH 'https://api.elevenlabs.io/v1/pronunciation-dictionaries/pronunciation-dictionary-id' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "archived": true,
  "name": "example-name"
}'

# PATCH /v1/pronunciation-dictionaries/{pronunciation_dictionary_id} (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-10-20

> Update Pronunciation Dictionary

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X PATCH 'https://api.elevenlabs.io/v1/pronunciation-dictionaries/pronunciation-dictionary-id' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"archived":true,"name":"example-name"}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| pronunciation_dictionary_id | path | string | Yes | The id of the pronunciation dictionary |
| archived | body | boolean | No | Whether to archive the pronunciation dictionary. |
| name | body | string | No | The name of the pronunciation dictionary, used for identi... |

## Response (200 OK)
{"created_by":"ar6633Es2kUjFXBdR1iVc9ztsXl1","creation_time_unix":1714156800}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

PATCH

PATCH /v1/pronunciation-dictionaries/{pronunciation_dictionary_id} — ElevenLabs API

ElevenLabs API

Update Pronunciation Dictionary

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 215 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X PATCH 'https://api.elevenlabs.io/v1/pronunciation-dictionaries/pronunciation-dictionary-id' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "archived": true,  "name": "example-name"}'

Parameters

Name	In	Type	Required	Description
pronunciation_dictionary_id	path	string	Yes	The id of the pronunciation dictionary
archived	body	boolean	No	Whether to archive the pronunciation dictionary.
name	body	string	No	The name of the pronunciation dictionary, used for identification only.

Response 200 OK

{
  "created_by": "ar6633Es2kUjFXBdR1iVc9ztsXl1",
  "creation_time_unix": 1714156800,
  "description": "This is a test dictionary",
  "id": "5xM3yVvZQKV0EfqQpLrJ",
  "latest_version_id": "5xM3yVvZQKV0EfqQpLr2",
  "latest_version_rules_num": 2,
  "name": "My Dictionary",
  "permission_on_resource": "admin"
}

Get a free ElevenLabs API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.