API Evangelist conversational phrasing for ElevenLabs API Documentation Enterprise 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 Enterprise API
  version: 1.0.0
extends: openapi/elevenlabs-enterprise-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: 13
- target: $.paths['/v1/dubbing/resource/{dubbing_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Studio-enabled dubbing resource
      effect: read
      questions:
      - How do I see the speakers, segments and languages inside a dubbing project?
      - Where can I check whether my dubbing renders have finished?
      instructions:
      - text: Get the dubbing resource for {dubbing_id}.
        slots:
          dubbing_id: path.dubbing_id
      - text: Show render status and segments of dubbing project {dubbing_id}.
        slots:
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/language'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a target language to a dubbing resource
      effect: write
      questions:
      - Can I add another target language to an existing dub?
      - Does adding a language to a dubbing resource generate the translation right away?
      instructions:
      - text: Add language {language} to dubbing {dubbing_id}.
        slots:
          language: requestBody.language
          dubbing_id: path.dubbing_id
      - text: Add {language} as a new target language on dubbing project {dubbing_id}.
        slots:
          language: requestBody.language
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}/segment'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new segment for a dubbing speaker
      effect: write
      questions:
      - How do I add a new timed segment for a speaker in my dub?
      - Can I supply the text and translations when creating a dubbing segment?
      instructions:
      - text: Create a segment from {start_time} to {end_time} for speaker {speaker_id} in dubbing {dubbing_id}.
        slots:
          start_time: requestBody.start_time
          end_time: requestBody.end_time
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
      - text: Add a segment {start_time}-{end_time} saying {text} for speaker {speaker_id} in {dubbing_id}.
        slots:
          start_time: requestBody.start_time
          end_time: requestBody.end_time
          text: requestBody.text
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/segment/{segment_id}/{language}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit one segment's text or timing in a language
      effect: write
      questions:
      - Can I fix the translated text of a single segment for just one language?
      - Will editing a segment's timing regenerate the dubbed audio automatically?
      instructions:
      - text: Change the text of segment {segment_id} in {language} of dubbing {dubbing_id} to {text}.
        slots:
          segment_id: path.segment_id
          language: path.language
          dubbing_id: path.dubbing_id
          text: requestBody.text
      - text: Retime segment {segment_id} ({language}) in {dubbing_id} to start {start_time} and end {end_time}.
        slots:
          segment_id: path.segment_id
          language: path.language
          dubbing_id: path.dubbing_id
          start_time: requestBody.start_time
          end_time: requestBody.end_time
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/migrate-segments'].post
  update:
    x-apievangelist-phrasing:
      intent: Reassign dubbing segments to another speaker
      effect: write
      questions:
      - A few lines were attributed to the wrong speaker; can I move them?
      - How do I reassign several dubbing segments to a different speaker at once?
      instructions:
      - text: Move segments {segment_ids} in dubbing {dubbing_id} to speaker {speaker_id}.
        slots:
          segment_ids: requestBody.segment_ids
          dubbing_id: path.dubbing_id
          speaker_id: requestBody.speaker_id
      - text: Reattribute segments {segment_ids} of {dubbing_id} to speaker {speaker_id}.
        slots:
          segment_ids: requestBody.segment_ids
          dubbing_id: path.dubbing_id
          speaker_id: requestBody.speaker_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/segment/{segment_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a segment from a dub
      effect: destructive
      questions:
      - How do I remove an unwanted segment from a dubbing project?
      - Can I delete one segment without touching the rest of the dub?
      instructions:
      - text: Delete segment {segment_id} from dubbing {dubbing_id}.
        slots:
          segment_id: path.segment_id
          dubbing_id: path.dubbing_id
      - text: Remove the segment {segment_id} in dubbing project {dubbing_id}.
        slots:
          segment_id: path.segment_id
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/transcribe'].post
  update:
    x-apievangelist-phrasing:
      intent: Re-transcribe selected dubbing segments
      effect: write
      questions:
      - Can I regenerate the source transcript for specific segments of a dub?
      - Does re-transcribing segments also redo translations?
      instructions:
      - text: Re-transcribe segments {segments} in dubbing {dubbing_id}.
        slots:
          segments: requestBody.segments
          dubbing_id: path.dubbing_id
      - text: Regenerate transcriptions for {segments} of dubbing project {dubbing_id}.
        slots:
          segments: requestBody.segments
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/translate'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate translations for dubbing segments
      effect: write
      questions:
      - How do I redo the translation for some segments in certain languages?
      - Will translating segments fill in any missing transcriptions first?
      instructions:
      - text: Translate segments {segments} into {languages} for dubbing {dubbing_id}.
        slots:
          segments: requestBody.segments
          languages: requestBody.languages
          dubbing_id: path.dubbing_id
      - text: Regenerate {languages} translations of segments {segments} in {dubbing_id}.
        slots:
          languages: requestBody.languages
          segments: requestBody.segments
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/dub'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate dubbed audio for segments and languages
      effect: write
      questions:
      - After fixing translations, how do I regenerate the dubbed speech?
      - Can I re-dub only a few segments in one language?
      instructions:
      - text: Dub segments {segments} in {languages} for dubbing {dubbing_id}.
        slots:
          segments: requestBody.segments
          languages: requestBody.languages
          dubbing_id: path.dubbing_id
      - text: Regenerate the dubbed audio for {segments} in languages {languages} of {dubbing_id}.
        slots:
          segments: requestBody.segments
          languages: requestBody.languages
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a dubbing speaker's voice or name
      effect: write
      questions:
      - Can I switch a speaker in my dub to a voice from the voice library?
      - How do I adjust stability or style for one speaker's dubbed voice?
      instructions:
      - text: Set speaker {speaker_id} in dubbing {dubbing_id} to voice {voice_id}.
        slots:
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
          voice_id: requestBody.voice_id
      - text: Rename speaker {speaker_id} of {dubbing_id} to {speaker_name}.
        slots:
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
          speaker_name: requestBody.speaker_name
      - text: Apply voice {voice_id} to speaker {speaker_id} in {dubbing_id} for languages {languages} only.
        slots:
          voice_id: requestBody.voice_id
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
          languages: requestBody.languages
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/speaker'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a new speaker to a dubbing resource
      effect: write
      questions:
      - Can I add a speaker the automatic dubbing missed?
      - How do I create a new dubbing speaker tied to a specific voice?
      instructions:
      - text: Add speaker {speaker_name} to dubbing {dubbing_id}.
        slots:
          speaker_name: requestBody.speaker_name
          dubbing_id: path.dubbing_id
      - text: Create a new speaker in {dubbing_id} using voice {voice_id}.
        slots:
          dubbing_id: path.dubbing_id
          voice_id: requestBody.voice_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}/similar-voices'].get
  update:
    x-apievangelist-phrasing:
      intent: Find library voices similar to a dubbing speaker
      effect: read
      questions:
      - Which library voices sound most like a speaker in my dub?
      - Can I get sample audio for voices similar to a dubbing speaker?
      instructions:
      - text: Find voices similar to speaker {speaker_id} in dubbing {dubbing_id}.
        slots:
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
      - text: Suggest the top 10 library voices matching speaker {speaker_id} of {dubbing_id}.
        slots:
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/render/{language}'].post
  update:
    x-apievangelist-phrasing:
      intent: Render the dubbed audio or video for a language
      effect: write
      questions:
      - How do I produce the final dubbed video for one language?
      - Are segments that were never dubbed left out of a render?
      - Can I normalize the volume when rendering a dub?
      instructions:
      - text: Render {language} for dubbing {dubbing_id} as {render_type}.
        slots:
          language: path.language
          dubbing_id: path.dubbing_id
          render_type: requestBody.render_type
      - text: Render the original track of {dubbing_id} as {render_type} with volume normalization {normalize_volume}.
        slots:
          dubbing_id: path.dubbing_id
          render_type: requestBody.render_type
          normalize_volume: requestBody.normalize_volume
      method: generated
      generated: '2026-09-26'