PronunciationDictResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/telnyx/json-schema/telnyx-pronunciation-dict-response-schema.json",
  "title": "PronunciationDictResponse",
  "description": "Response containing a single pronunciation dictionary.",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/telnyx-pronunciation-dictionaries-api-openapi.yml#/components/schemas/PronunciationDictResponse",
  "properties": {
    "data": {
      "$ref": "#/$defs/PronunciationDictData"
    }
  },
  "type": "object",
  "$defs": {
    "PronunciationDictAliasItem": {
      "additionalProperties": false,
      "description": "An alias pronunciation item. When the `text` value is found in input, it is replaced with the `alias` before speech synthesis.",
      "properties": {
        "alias": {
          "description": "The replacement text that will be spoken instead.",
          "maxLength": 500,
          "minLength": 1,
          "type": "string"
        },
        "text": {
          "description": "The text to match in the input. Case-insensitive matching is used during synthesis.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "type": {
          "description": "The item type.",
          "enum": [
            "alias"
          ],
          "type": "string"
        }
      },
      "required": [
        "text",
        "type",
        "alias"
      ],
      "type": "object"
    },
    "PronunciationDictData": {
      "description": "A pronunciation dictionary record.",
      "properties": {
        "created_at": {
          "description": "ISO 8601 timestamp with millisecond precision.",
          "format": "date-time",
          "type": "string"
        },
        "id": {
          "description": "Unique identifier for the pronunciation dictionary.",
          "format": "uuid",
          "type": "string"
        },
        "items": {
          "description": "List of pronunciation items (alias or phoneme type).",
          "items": {
            "$ref": "#/$defs/PronunciationDictItem"
          },
          "type": "array"
        },
        "name": {
          "description": "Human-readable name for the dictionary. Must be unique within the organization.",
          "type": "string"
        },
        "record_type": {
          "description": "Identifies the resource type.",
          "enum": [
            "pronunciation_dict"
          ],
          "type": "string"
        },
        "updated_at": {
          "description": "ISO 8601 timestamp with millisecond precision.",
          "format": "date-time",
          "type": "string"
        },
        "version": {
          "description": "Auto-incrementing version number. Increases by 1 on each update. Used for optimistic concurrency control and cache invalidation.",
          "type": "integer"
        }
      },
      "type": "object"
    },
    "PronunciationDictItem": {
      "description": "A single pronunciation dictionary item. Use type 'alias' to replace matched text with a spoken alias, or type 'phoneme' to specify exact pronunciation using IPA notation.",
      "oneOf": [
        {
          "$ref": "#/$defs/PronunciationDictAliasItem"
        },
        {
          "$ref": "#/$defs/PronunciationDictPhonemeItem"
        }
      ]
    },
    "PronunciationDictPhonemeItem": {
      "additionalProperties": false,
      "description": "A phoneme pronunciation item. When the `text` value is found in input, it is pronounced using the specified IPA phoneme notation.",
      "properties": {
        "alphabet": {
          "description": "The phonetic alphabet used for the phoneme notation.",
          "enum": [
            "ipa"
          ],
          "type": "string"
        },
        "phoneme": {
          "description": "The phoneme notation representing the desired pronunciation.",
          "maxLength": 500,
          "minLength": 1,
          "type": "string"
        },
        "text": {
          "description": "The text to match in the input. Case-insensitive matching is used during synthesis.",
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        },
        "type": {
          "description": "The item type.",
          "enum": [
            "phoneme"
          ],
          "type": "string"
        }
      },
      "required": [
        "text",
        "type",
        "phoneme",
        "alphabet"
      ],
      "type": "object"
    }
  }
}