Skip to main content
POST
create pronunciation dictionary

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required

Display name. Names don't have to be unique; leading and trailing spaces are removed.

Required string length: 1 - 200
Example:

"Brand names"

entries
object[]

Dictionary entries. Omit to create an empty dictionary.

Maximum array length: 500

Response

Successfully created pronunciation dictionary

A pronunciation dictionary and its entries. Saves are live: sessions that start after a save use the saved entries, and running sessions keep the entries they started with.

id
string<uuid>

Pronunciation dictionary ID. Pass it as voiceGenerationOptions.pronunciationDictionaryId when creating a session token.

Example:

"4f600129-13cf-4bfa-909a-2f4c31467f43"

name
string

Display name

Example:

"Brand names"

revision
integer

Starts at 1 and increases with every save. Send it as expectedRevision to reject a write if someone else saved first.

Required range: x >= 1
Example:

1

createdAt
string<date-time>

When the dictionary was created

updatedAt
string<date-time>

When the dictionary was last saved

entries
object[]
Last modified on October 13, 2026