API Evangelist conversational phrasing for ElevenLabs API Documentation Speech Engine API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for ElevenLabs API Documentation Speech Engine API
  version: 1.0.0
extends: openapi/elevenlabs-speech-engine-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/v1/speech-engine'].get
  update:
    x-apievangelist-phrasing:
      intent: List Speech Engines
      effect: read
      questions:
      - Which Speech Engine resources have I configured?
      - Can I search my Speech Engines by name?
      instructions:
      - text: List my Speech Engines.
      - text: Search Speech Engines for {search}.
        slots:
          search: query.search
      - text: List Speech Engines sorted by {sort_by} {sort_direction}.
        slots:
          sort_by: query.sort_by
          sort_direction: query.sort_direction
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/speech-engine'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Speech Engine
      effect: write
      questions:
      - How do I set up a Speech Engine with my own speech recognition and TTS settings?
      - Can I configure turn taking, privacy and call limits on a new Speech Engine?
      instructions:
      - text: Create a Speech Engine named {name} with config {speech_engine}.
        slots:
          name: requestBody.name
          speech_engine: requestBody.speech_engine
      - text: Create a Speech Engine from {speech_engine} using ASR {asr} and TTS {tts}.
        slots:
          speech_engine: requestBody.speech_engine
          asr: requestBody.asr
          tts: requestBody.tts
      - text: Set up a {language} Speech Engine from {speech_engine} with call limits {call_limits}.
        slots:
          language: requestBody.language
          speech_engine: requestBody.speech_engine
          call_limits: requestBody.call_limits
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/speech-engine/{speech_engine_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Speech Engine
      effect: read
      questions:
      - How is a particular Speech Engine configured?
      - Can I look up one Speech Engine by its ID?
      instructions:
      - text: Get Speech Engine {speech_engine_id}.
        slots:
          speech_engine_id: path.speech_engine_id
      - text: Show the settings of Speech Engine {speech_engine_id}.
        slots:
          speech_engine_id: path.speech_engine_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/speech-engine/{speech_engine_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Speech Engine
      effect: destructive
      questions:
      - How do I remove a Speech Engine I no longer need?
      - Can I delete a Speech Engine by ID?
      instructions:
      - text: Delete Speech Engine {speech_engine_id}.
        slots:
          speech_engine_id: path.speech_engine_id
      - text: Remove the Speech Engine {speech_engine_id} permanently.
        slots:
          speech_engine_id: path.speech_engine_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/speech-engine/{speech_engine_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Speech Engine's settings
      effect: write
      questions:
      - Can I change just the TTS settings of an existing Speech Engine?
      - Is it possible to tweak voice activity detection on a Speech Engine without resending everything?
      instructions:
      - text: Rename Speech Engine {speech_engine_id} to {name}.
        slots:
          speech_engine_id: path.speech_engine_id
          name: requestBody.name
      - text: Update the TTS settings of Speech Engine {speech_engine_id} to {tts}.
        slots:
          speech_engine_id: path.speech_engine_id
          tts: requestBody.tts
      - text: Change voice activity detection on {speech_engine_id} to {vad}.
        slots:
          speech_engine_id: path.speech_engine_id
          vad: requestBody.vad
      method: generated
      generated: '2026-09-26'