API Evangelist conversational phrasing for Elevenlabs Voices 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 Voices API
  version: 1.0.0
extends: openapi/elevenlabs-voices-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: 14
- target: $.paths['/v1/voices'].get
  update:
    x-apievangelist-phrasing:
      intent: List all voices available to me
      effect: read
      questions:
      - Which voices can I use for text to speech in ElevenLabs?
      - Can I include legacy voices in my voice list?
      instructions:
      - text: List all my available voices, pre-built and custom.
      - text: List my voices with legacy voices shown set to {show_legacy}.
        slots:
          show_legacy: query.show_legacy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/voices/{voice_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a voice's details
      effect: read
      questions:
      - What labels, samples and description does a particular voice have?
      - Can I see a voice's metadata together with its settings in one call?
      instructions:
      - text: Get the details of voice {voice_id}.
        slots:
          voice_id: path.voice_id
      - text: Show voice {voice_id} including its settings ({with_settings}).
        slots:
          voice_id: path.voice_id
          with_settings: query.with_settings
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/voices/{voice_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a voice from my library
      effect: destructive
      questions:
      - How do I delete a custom voice I made?
      - Are a voice's samples removed when I delete it?
      instructions:
      - text: Delete voice {voice_id} from my library.
        slots:
          voice_id: path.voice_id
      - text: Permanently remove voice {voice_id} and its samples.
        slots:
          voice_id: path.voice_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/voices/{voice_id}/edit'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename or relabel a voice and add samples
      effect: write
      questions:
      - Can I rename one of my voices or change its description?
      - How do I upload extra samples to a voice I already have?
      instructions:
      - text: Rename voice {voice_id} to {name}.
        slots:
          voice_id: path.voice_id
          name: requestBody.name
      - text: Update voice {voice_id} with name {name}, description {description} and labels {labels}.
        slots:
          voice_id: path.voice_id
          name: requestBody.name
          description: requestBody.description
          labels: requestBody.labels
      - text: Add samples {files} to existing voice {voice_id} named {name}.
        slots:
          files: requestBody.files
          voice_id: path.voice_id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/voices/add'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a new voice from audio samples
      effect: write
      questions:
      - How do I create a voice clone from my own recordings?
      - What do I need to upload to add a brand new voice?
      instructions:
      - text: Create a new voice named {name} from samples {files}.
        slots:
          name: requestBody.name
          files: requestBody.files
      - text: Clone a voice called {name} from {files} with description {description}.
        slots:
          name: requestBody.name
          files: requestBody.files
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/voices/settings/default'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the default voice settings
      effect: read
      questions:
      - What stability and similarity values do voices use by default?
      - Which account-wide default settings apply when a voice has none of its own?
      instructions:
      - text: Show the default voice settings.
      - text: Get the baseline stability and clarity defaults for voices.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/voices/{voice_id}/settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the settings of one voice
      effect: read
      questions:
      - What stability and style is a particular voice currently set to?
      - Can I check the similarity boost for one of my voices?
      instructions:
      - text: Get the settings for voice {voice_id}.
        slots:
          voice_id: path.voice_id
      - text: Show stability, similarity and speed for voice {voice_id}.
        slots:
          voice_id: path.voice_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/voices/{voice_id}/settings/edit'].post
  update:
    x-apievangelist-phrasing:
      intent: Change a voice's stability, style or speed
      effect: write
      questions:
      - How do I make a voice sound more stable or more expressive?
      - Can I change the default speaking speed of one voice?
      instructions:
      - text: Set voice {voice_id} stability to {stability} and similarity boost to {similarity_boost}.
        slots:
          voice_id: path.voice_id
          stability: requestBody.stability
          similarity_boost: requestBody.similarity_boost
      - text: Change the speed of voice {voice_id} to {speed}.
        slots:
          voice_id: path.voice_id
          speed: requestBody.speed
      - text: Set style {style} and speaker boost {use_speaker_boost} on voice {voice_id}.
        slots:
          style: requestBody.style
          use_speaker_boost: requestBody.use_speaker_boost
          voice_id: path.voice_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/voices/accents'].get
  update:
    x-apievangelist-phrasing:
      intent: List accents in the shared voice library
      effect: read
      questions:
      - What accents can I filter shared voices by?
      - Which accents are available for a given language?
      instructions:
      - text: List the accents available in the shared voice library.
      - text: Show shared-library accents for language {language}.
        slots:
          language: query.language
      - text: List accents supported for model {model_id}.
        slots:
          model_id: query.model_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/voices'].get
  update:
    x-apievangelist-phrasing:
      intent: Search and filter my voices
      effect: read
      questions:
      - Can I search my own voices by name and page through them?
      - How can I find only my cloned voices, or only female voices?
      - Is there a way to count how many voices I have in total?
      instructions:
      - text: Search my voices for {search}.
        slots:
          search: query.search
      - text: List my voices of type {voice_type} in category {category}.
        slots:
          voice_type: query.voice_type
          category: query.category
      - text: Show my {gender} voices in {language}, including the total count.
        slots:
          gender: query.gender
          language: query.language
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/voices/{voice_id}/replicate-to-isolated-environment'].post
  update:
    x-apievangelist-phrasing:
      intent: Copy a voice to another data-residency workspace
      effect: write
      questions:
      - Can I copy my instant voice clone to a workspace in a different data residency?
      - Is it possible to keep the same voice ID when replicating a voice?
      instructions:
      - text: Replicate voice {voice_id} to workspace {target_workspace_id}.
        slots:
          voice_id: path.voice_id
          target_workspace_id: requestBody.target_workspace_id
      - text: Copy voice {voice_id} to isolated workspace {target_workspace_id}, keeping the voice ID {preserve_voice_id}.
        slots:
          voice_id: path.voice_id
          target_workspace_id: requestBody.target_workspace_id
          preserve_voice_id: requestBody.preserve_voice_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/voices/add/{public_user_id}/{voice_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a shared voice to my collection
      effect: write
      questions:
      - How do I save a community voice into my own voices?
      - Can I bookmark a shared voice when adding it?
      instructions:
      - text: Add shared voice {voice_id} from user {public_user_id} as {new_name}.
        slots:
          voice_id: path.voice_id
          public_user_id: path.public_user_id
          new_name: requestBody.new_name
      - text: Save {public_user_id}'s voice {voice_id} to my voices under the name {new_name} and bookmark it.
        slots:
          public_user_id: path.public_user_id
          voice_id: path.voice_id
          new_name: requestBody.new_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/similar-voices'].post
  update:
    x-apievangelist-phrasing:
      intent: Find shared voices that sound like an audio sample
      effect: read
      questions:
      - Can I upload a clip and find library voices that sound like it?
      - How many similar voices come back, and can I set a similarity threshold?
      instructions:
      - text: Find shared voices similar to audio {audio_file}.
        slots:
          audio_file: requestBody.audio_file
      - text: Return the top {top_k} library voices matching {audio_file}.
        slots:
          top_k: requestBody.top_k
          audio_file: requestBody.audio_file
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/shared-voices'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse the shared voice library
      effect: read
      questions:
      - What community voices are available in the shared library?
      - Can I browse featured shared voices by accent or use case?
      instructions:
      - text: Browse shared voices matching {search}.
        slots:
          search: query.search
      - text: List shared library voices with accent {accent} for use case {use_cases}.
        slots:
          accent: query.accent
          use_cases: query.use_cases
      - text: Show featured shared voices in {language}.
        slots:
          language: query.language
      method: generated
      generated: '2026-09-26'