Skip to main content
POST
Create pronunciation dictionary
For workflow examples, see the Pronunciation dictionaries guide.

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

Unique dictionary name within the authenticated organization.

Maximum string length: 128
Pattern: ^[A-Za-z0-9._-]+$
Example:

"brand-pronunciations"

modes
object
required

Pronunciation modes stored on the dictionary. Only rewrite is executable today.

metadata
object

Optional application metadata stored with the dictionary.

Example:

Response

Pronunciation dictionary created.

id
string
required

Immutable pronunciation dictionary identifier.

Example:

"pd_01abc..."

org_id
string
required

Organization that owns the dictionary.

Example:

"org_123"

name
string
required

Dictionary name.

Example:

"brand-pronunciations"

normalized_name
string
required

Normalized dictionary name used for lookups.

Example:

"brand-pronunciations"

modes
object
required

Pronunciation modes stored on the dictionary. Only rewrite is executable today.

content_hash
string
required

Content hash for the stored dictionary.

Example:

"sha256:..."

created_at
string<date-time>
required

Creation timestamp.

Example:

"2026-05-15T12:00:00.000Z"

metadata
object

Optional application metadata stored with the dictionary.

Example:
created_by_key_label
string

API key label that created the dictionary, when available.

Example:

"production-key"