---
title: "Create Pronunciation Dictionaries"
method: POST
path: "/v1/studio/projects/{project_id}/pronunciation-dictionaries"
tags: ["studio"]
---

# Create Pronunciation Dictionaries

`POST /v1/studio/projects/{project_id}/pronunciation-dictionaries`

Create a set of pronunciation dictionaries acting on a project. This will automatically mark text within this project as requiring reconverting where the new dictionary would apply or the old one no longer does.

## Path parameters

- `project_id` string, required — The ID of the Studio project.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Request body

- BodyCreatePronunciationDictionariesV1StudioProjectsProjectIdPronunciationDictionariesPost
  - `pronunciation_dictionary_locators` PronunciationDictionaryVersionLocatorDBModel[], required — A list of pronunciation dictionary locators (pronunciation_dictionary_id, version_id) encoded as a list of JSON strings for pronunciation dictionaries to be applied to the text. A list of json encoded strings is required as adding projects may occur through formData as opposed to jsonBody. To specify multiple dictionaries use multiple --form lines in your curl, such as --form 'pronunciation_dictionary_locators="{\"pronunciation_dictionary_id\":\"Vmd4Zor6fplcA7WrINey\",\"version_id\":\"hRPaxjlTdR7wFMhV4w0b\"}"' --form 'pronunciation_dictionary_locators="{\"pronunciation_dictionary_id\":\"JzWtcGQMJ6bnlWwyMo7e\",\"version_id\":\"lbmwxiLu4q6txYxgdZqn\"}"'.
    - `pronunciation_dictionary_id` string, required
    - `version_id` string, nullable, required
  - `invalidate_affected_text` boolean — This will automatically mark text in this project for reconversion when the new dictionary applies or the old one no longer does.

## Response `200`

Successful Response

- CreatePronunciationDictionaryResponseModel
  - `status` string, required — The status of the create pronunciation dictionary request. If the request was successful, the status will be 'ok'. Otherwise an error message with status 500 will be returned.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/d1075d6a6487/schema)