Pronunciation dictionaries
List pronunciation dictionaries
List named pronunciation dictionaries and their complete contents.
/pronunciations/v1/workspaces/{workspaceId}/pronunciationDictionariesList responses include the complete contents of each dictionary, so pages contain at most five dictionaries. Treat nextPageToken as opaque and pass it back unchanged to retrieve the next page.
Authorizationstringrequired
Your authentication credentials. For Basic authentication, send Basic $INWORLD_API_KEY. Use a Standard API key for the target workspace. Voices Read access permits list and get; Voices Write access permits all five methods.
workspaceIdstringrequired
ID of the workspace that owns the dictionary. It must match a workspace accessible to the API key.
pageSizeintegerdefault: 5
Maximum number of dictionaries to return. Omit or set to 0 to use the default of 5. Values above 5 are reduced to 5; negative values are rejected.
pageTokenstring
Opaque token returned as nextPageToken by the preceding list request. Keep the workspace unchanged when continuing a page sequence.
pronunciationDictionariesobject[]required
Named dictionaries in stable service-defined order, including their complete contents.
Show child attributes
namestringrequired
Service-assigned resource name in the form workspaces/{workspace}/pronunciationDictionaries/{uuid}.
displayNamestringrequired
Non-blank human-readable dictionary name, containing at most 64 Unicode code points.
pronunciationsobject[]requireddefault: []
Complete dictionary contents. A dictionary can contain up to 1,000 entries and must remain within the 512 KiB encoded dictionary limit. Entries must be unique after language-aware lexical canonicalization.
Show child attributes
displayHeadwordstringrequired
Caller-facing spelling. It must be non-blank and tokenize to exactly one replaceable lexical token.
languageCodestringrequired
Concrete language supported for pronunciation entries, in its exact canonical BCP-47 spelling: for example, en-US, not en-us, EN_US, or en. Blank values and auto are not accepted. The general TTS language list is not a pronunciation catalog. See Author pronunciation entries.
phoneSymbolsstring[]required
Ordered array of complete phone tokens supported for the selected language, not a slash-delimited or whitespace-separated IPA string. Each token can contain at most 16 Unicode code points. Preserve compound-phone token boundaries; do not split by Unicode character. Supported aliases may be canonicalized in the response. See phone-token guidance and examples.
etagstringrequired
Optimistic-concurrency token. Include the current value when updating or deleting the dictionary.
createTimestringrequired
Time at which the dictionary was created.
updateTimestringrequired
Time at which the dictionary's metadata or contents last changed.
nextPageTokenstringrequired
Opaque token for the next page, or an empty string when this is the final page.