API Evangelist conversational phrasing for ElevenLabs API Documentation Segment 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 Segment API
  version: 1.0.0
extends: openapi/elevenlabs-segment-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: Fetch a dubbing resource by ID
      effect: read
      questions:
      - What's inside my dubbing resource right now?
      - Can I read back the current state of a dub made with Studio enabled?
      instructions:
      - text: Fetch dubbing resource {dubbing_id}.
        slots:
          dubbing_id: path.dubbing_id
      - text: Look up the speakers and languages of dub {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 language to a dub
      effect: write
      questions:
      - Can I extend an existing dub with one more language?
      - Which language codes can be added to a dubbing resource?
      instructions:
      - text: Extend dub {dubbing_id} with the language {language}.
        slots:
          dubbing_id: path.dubbing_id
          language: requestBody.language
      - text: Put {language} on dubbing resource {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: Add a timed segment for a speaker
      effect: write
      questions:
      - Can I insert a new clip for a speaker between two timestamps?
      - Does a newly added segment appear in every language of the dub?
      instructions:
      - text: Insert a clip for speaker {speaker_id} in {dubbing_id} starting {start_time} and ending {end_time}.
        slots:
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
          start_time: requestBody.start_time
          end_time: requestBody.end_time
      - text: New segment for {speaker_id} on dub {dubbing_id}, {start_time} to {end_time}, with translations {translations}.
        slots:
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
          start_time: requestBody.start_time
          end_time: requestBody.end_time
          translations: requestBody.translations
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/segment/{segment_id}/{language}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Modify a segment for one language
      effect: write
      questions:
      - How do I correct a single line of dubbed text in one target language?
      - Can I shift a segment's start and end time for only one language?
      instructions:
      - text: Update {language} text of segment {segment_id} on dub {dubbing_id} to {text}.
        slots:
          language: path.language
          segment_id: path.segment_id
          dubbing_id: path.dubbing_id
          text: requestBody.text
      - text: Shift segment {segment_id} in {language} of {dubbing_id} to {start_time} through {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: Move segments between speakers
      effect: write
      questions:
      - Can I transfer segments from one speaker to another in a dub?
      - What do I need to move a batch of segments to a new speaker?
      instructions:
      - text: Transfer segments {segment_ids} to speaker {speaker_id} on dub {dubbing_id}.
        slots:
          segment_ids: requestBody.segment_ids
          speaker_id: requestBody.speaker_id
          dubbing_id: path.dubbing_id
      - text: Give speaker {speaker_id} ownership of segments {segment_ids} in {dubbing_id}.
        slots:
          speaker_id: requestBody.speaker_id
          segment_ids: requestBody.segment_ids
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/segment/{segment_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a single dubbing segment
      effect: destructive
      questions:
      - Is there a way to drop one segment from a dub entirely?
      - What happens to a segment's translations when I delete it?
      instructions:
      - text: Drop segment {segment_id} from dub {dubbing_id}.
        slots:
          segment_id: path.segment_id
          dubbing_id: path.dubbing_id
      - text: Erase segment {segment_id} of dubbing resource {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: Transcribe specific segments again
      effect: write
      questions:
      - The source transcript for some segments is wrong; can I redo just those?
      - Which segments get re-transcribed when I call transcribe on a dub?
      instructions:
      - text: Redo the transcript for segments {segments} on dub {dubbing_id}.
        slots:
          segments: requestBody.segments
          dubbing_id: path.dubbing_id
      - text: Transcribe only {segments} again in dubbing resource {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: Translate some or all segments again
      effect: write
      questions:
      - Can I retranslate a dub into just two of its languages?
      - Does retranslating segments regenerate the dubbed audio too?
      instructions:
      - text: Retranslate {segments} into {languages} on dub {dubbing_id}.
        slots:
          segments: requestBody.segments
          languages: requestBody.languages
          dubbing_id: path.dubbing_id
      - text: Refresh {languages} translations for segments {segments} of {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: Re-dub segments in chosen languages
      effect: write
      questions:
      - How do I regenerate speech for edited segments in a dub?
      - Will re-dubbing fill in missing transcripts and translations automatically?
      instructions:
      - text: Re-dub {segments} in {languages} on dubbing resource {dubbing_id}.
        slots:
          segments: requestBody.segments
          languages: requestBody.languages
          dubbing_id: path.dubbing_id
      - text: Generate new dubbed speech in {languages} for segments {segments} of {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}/speaker/{speaker_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a dubbing speaker's metadata
      effect: write
      questions:
      - Can I clone a speaker's own voice from the track instead of using a library voice?
      - How do I change a dubbing speaker's voice similarity setting?
      instructions:
      - text: Point speaker {speaker_id} on dub {dubbing_id} at voice {voice_id}, or track-clone to clone it from the track.
        slots:
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
          voice_id: requestBody.voice_id
      - text: Set voice similarity {voice_similarity} for speaker {speaker_id} in {dubbing_id}.
        slots:
          voice_similarity: requestBody.voice_similarity
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/speaker'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a speaker in a dub
      effect: write
      questions:
      - Can I create an extra speaker in a dub and give it voice settings?
      - Is a new dubbing speaker added across all languages?
      instructions:
      - text: Create speaker {speaker_name} on dub {dubbing_id} with voice {voice_id}.
        slots:
          speaker_name: requestBody.speaker_name
          dubbing_id: path.dubbing_id
          voice_id: requestBody.voice_id
      - text: Add a speaker to dubbing resource {dubbing_id} with stability {voice_stability}.
        slots:
          dubbing_id: path.dubbing_id
          voice_stability: requestBody.voice_stability
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}/similar-voices'].get
  update:
    x-apievangelist-phrasing:
      intent: Search the library for voices like a speaker
      effect: read
      questions:
      - Can ElevenLabs recommend library voices that match someone in my dub?
      - How many similar voices are returned for a dubbing speaker?
      instructions:
      - text: Recommend library voices like speaker {speaker_id} on dub {dubbing_id}.
        slots:
          speaker_id: path.speaker_id
          dubbing_id: path.dubbing_id
      - text: Search for voices resembling {speaker_id} in dubbing resource {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 dubbed output for one language
      effect: write
      questions:
      - How do I export the finished dub in a given language?
      - Are dub renders asynchronous, and where do I check their status?
      instructions:
      - text: Export dub {dubbing_id} in {language} as {render_type}.
        slots:
          dubbing_id: path.dubbing_id
          language: path.language
          render_type: requestBody.render_type
      - text: Produce the {language} {render_type} for {dubbing_id} with normalize_volume {normalize_volume}.
        slots:
          language: path.language
          render_type: requestBody.render_type
          dubbing_id: path.dubbing_id
          normalize_volume: requestBody.normalize_volume
      method: generated
      generated: '2026-09-26'