API Evangelist conversational phrasing for ElevenLabs API Documentation Studio 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 Studio API
  version: 1.0.0
extends: openapi/elevenlabs-studio-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: 23
- target: $.paths['/v1/studio/podcasts'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a podcast from source content
      effect: write
      questions:
      - Can ElevenLabs turn an article or document into a two-host podcast automatically?
      - What's the difference between a conversation podcast and a bulletin podcast?
      - Can I make a generated podcast shorter than three minutes or add a fixed intro and outro?
      instructions:
      - text: Create a {mode} podcast from {source} using model {model_id}.
        slots:
          mode: requestBody.mode
          source: requestBody.source
          model_id: requestBody.model_id
      - text: Generate a short podcast from {source} with model {model_id} in {mode} mode and duration {duration_scale}.
        slots:
          source: requestBody.source
          model_id: requestBody.model_id
          mode: requestBody.mode
          duration_scale: requestBody.duration_scale
      - text: Make a {mode} podcast from {source} with model {model_id} that always opens with {intro}.
        slots:
          mode: requestBody.mode
          source: requestBody.source
          model_id: requestBody.model_id
          intro: requestBody.intro
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/pronunciation-dictionaries'].post
  update:
    x-apievangelist-phrasing:
      intent: Attach pronunciation dictionaries to a Studio project
      effect: write
      questions:
      - How do I make a Studio project pronounce names consistently using a pronunciation dictionary?
      - Will adding a pronunciation dictionary mark already-converted text for reconversion?
      instructions:
      - text: Apply pronunciation dictionaries {pronunciation_dictionary_locators} to Studio project {project_id}.
        slots:
          pronunciation_dictionary_locators: requestBody.pronunciation_dictionary_locators
          project_id: path.project_id
      - text: 'Set dictionaries {pronunciation_dictionary_locators} on project {project_id} and invalidate affected text: {invalidate_affected_text}.'
        slots:
          pronunciation_dictionary_locators: requestBody.pronunciation_dictionary_locators
          project_id: path.project_id
          invalidate_affected_text: requestBody.invalidate_affected_text
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects'].get
  update:
    x-apievangelist-phrasing:
      intent: List my Studio projects
      effect: read
      questions:
      - What Studio projects do I have?
      - Can I get all my long-form Studio projects with their metadata?
      instructions:
      - text: List my Studio projects.
      - text: Show every Studio project in my account.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Studio project
      effect: write
      questions:
      - How do I start a new audiobook project in Studio from an EPUB or PDF?
      - Can a new Studio project be initialized from a web page URL?
      - Which metadata like author, ISBN or genre can I set when creating a project?
      instructions:
      - text: Create a Studio project named {name}.
        slots:
          name: requestBody.name
      - text: 'Start Studio project {name} from the document {from_document} and auto-convert it: {auto_convert}.'
        slots:
          name: requestBody.name
          from_document: requestBody.from_document
          auto_convert: requestBody.auto_convert
      - text: Create project {name} by importing content from {from_url} with paragraph voice {default_paragraph_voice_id}.
        slots:
          name: requestBody.name
          from_url: requestBody.from_url
          default_paragraph_voice_id: requestBody.default_paragraph_voice_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Studio project's details
      effect: read
      questions:
      - How do I see the full details of one Studio project?
      - Can I open a project someone shared with me using its share ID?
      instructions:
      - text: Get Studio project {project_id}.
        slots:
          project_id: path.project_id
      - text: Show details for project {project_id} with share ID {share_id}.
        slots:
          project_id: path.project_id
          share_id: query.share_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a Studio project's settings
      effect: write
      questions:
      - Can I rename a Studio project or change its default voices?
      - How do I update the author or ISBN metadata on an existing project?
      instructions:
      - text: 'Update project {project_id}: name {name}, title voice {default_title_voice_id}, paragraph voice {default_paragraph_voice_id}.'
        slots:
          project_id: path.project_id
          name: requestBody.name
          default_title_voice_id: requestBody.default_title_voice_id
          default_paragraph_voice_id: requestBody.default_paragraph_voice_id
      - text: Set author {author} on project {project_id} keeping name {name} and voices {default_title_voice_id} and {default_paragraph_voice_id}.
        slots:
          author: requestBody.author
          project_id: path.project_id
          name: requestBody.name
          default_title_voice_id: requestBody.default_title_voice_id
          default_paragraph_voice_id: requestBody.default_paragraph_voice_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Studio project
      effect: destructive
      questions:
      - How do I permanently remove a Studio project I no longer need?
      - Is deleting a Studio project reversible?
      instructions:
      - text: Delete Studio project {project_id}.
        slots:
          project_id: path.project_id
      - text: Remove the project {project_id} from Studio.
        slots:
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/content'].post
  update:
    x-apievangelist-phrasing:
      intent: Replace a Studio project's content
      effect: write
      questions:
      - Can I swap the text of an existing Studio project with a new document?
      - How do I refresh a project's content from an updated URL?
      instructions:
      - text: Replace the content of project {project_id} with the document {from_document}.
        slots:
          project_id: path.project_id
          from_document: requestBody.from_document
      - text: 'Reload project {project_id} content from {from_url} and auto-convert: {auto_convert}.'
        slots:
          project_id: path.project_id
          from_url: requestBody.from_url
          auto_convert: requestBody.auto_convert
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/convert'].post
  update:
    x-apievangelist-phrasing:
      intent: Convert a whole Studio project to audio
      effect: write
      questions:
      - How do I render every chapter of my Studio project to audio at once?
      - Does converting a project also convert all of its chapters?
      instructions:
      - text: Convert Studio project {project_id} and all its chapters.
        slots:
          project_id: path.project_id
      - text: Start audio conversion for the entire project {project_id}.
        slots:
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/snapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List a Studio project's snapshots
      effect: read
      questions:
      - Where can I find past rendered versions of my Studio project?
      - Which snapshots exist for a project?
      instructions:
      - text: List snapshots for project {project_id}.
        slots:
          project_id: path.project_id
      - text: Show all project-level snapshots of {project_id}.
        slots:
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/snapshots/{project_snapshot_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Studio project snapshot
      effect: read
      questions:
      - How do I fetch the details of a specific project snapshot?
      - Can I check one project snapshot before downloading it?
      instructions:
      - text: Get snapshot {project_snapshot_id} of project {project_id}.
        slots:
          project_snapshot_id: path.project_snapshot_id
          project_id: path.project_id
      - text: Show project snapshot {project_snapshot_id} for {project_id}.
        slots:
          project_snapshot_id: path.project_snapshot_id
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/snapshots/{project_snapshot_id}/stream'].post
  update:
    x-apievangelist-phrasing:
      intent: Stream audio from a project snapshot
      effect: read
      questions:
      - Can I stream the rendered audio of a whole project snapshot?
      - Is there an option to get the project snapshot audio as MPEG?
      instructions:
      - text: Stream audio of project snapshot {project_snapshot_id} in project {project_id}.
        slots:
          project_snapshot_id: path.project_snapshot_id
          project_id: path.project_id
      - text: 'Stream project {project_id} snapshot {project_snapshot_id} converted to mpeg: {convert_to_mpeg}.'
        slots:
          project_id: path.project_id
          project_snapshot_id: path.project_snapshot_id
          convert_to_mpeg: requestBody.convert_to_mpeg
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/snapshots/{project_snapshot_id}/archive'].post
  update:
    x-apievangelist-phrasing:
      intent: Download a project snapshot as an archive
      effect: read
      questions:
      - How do I download all of a project's audio as a single compressed file?
      - Can I get a zip archive of a Studio project snapshot?
      instructions:
      - text: Download the archive for snapshot {project_snapshot_id} of project {project_id}.
        slots:
          project_snapshot_id: path.project_snapshot_id
          project_id: path.project_id
      - text: Get a compressed archive of project {project_id} audio from snapshot {project_snapshot_id}.
        slots:
          project_id: path.project_id
          project_snapshot_id: path.project_snapshot_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/chapters'].get
  update:
    x-apievangelist-phrasing:
      intent: List chapters in a Studio project
      effect: read
      questions:
      - What chapters does my Studio project contain?
      - How can I list a project's chapters?
      instructions:
      - text: List the chapters of project {project_id}.
        slots:
          project_id: path.project_id
      - text: Show all chapters in Studio project {project_id}.
        slots:
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/chapters'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a chapter to a Studio project
      effect: write
      questions:
      - Can I add a new chapter to an existing project from a URL?
      - How do I create a blank chapter in a Studio project?
      instructions:
      - text: Add chapter {name} to project {project_id}.
        slots:
          name: requestBody.name
          project_id: path.project_id
      - text: Create chapter {name} in project {project_id} from {from_url}.
        slots:
          name: requestBody.name
          project_id: path.project_id
          from_url: requestBody.from_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/chapters/{chapter_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a chapter's details
      effect: read
      questions:
      - How do I look up the details of one chapter in a project?
      - Can I check a single chapter's conversion state?
      instructions:
      - text: Get chapter {chapter_id} of project {project_id}.
        slots:
          chapter_id: path.chapter_id
          project_id: path.project_id
      - text: Show details for chapter {chapter_id} in {project_id}.
        slots:
          chapter_id: path.chapter_id
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/chapters/{chapter_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a chapter's name or content
      effect: write
      questions:
      - Can I rename a chapter or replace its text?
      - How do I edit the content of a single chapter?
      instructions:
      - text: Rename chapter {chapter_id} in project {project_id} to {name}.
        slots:
          chapter_id: path.chapter_id
          project_id: path.project_id
          name: requestBody.name
      - text: Replace the content of chapter {chapter_id} in {project_id} with {content}.
        slots:
          chapter_id: path.chapter_id
          project_id: path.project_id
          content: requestBody.content
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/chapters/{chapter_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a chapter from a project
      effect: destructive
      questions:
      - How do I remove one chapter from a Studio project?
      - Can I delete a chapter without deleting the whole project?
      instructions:
      - text: Delete chapter {chapter_id} from project {project_id}.
        slots:
          chapter_id: path.chapter_id
          project_id: path.project_id
      - text: Remove the chapter {chapter_id} in {project_id}.
        slots:
          chapter_id: path.chapter_id
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/chapters/{chapter_id}/convert'].post
  update:
    x-apievangelist-phrasing:
      intent: Convert a single chapter to audio
      effect: write
      questions:
      - Can I convert just one chapter instead of the whole project?
      - Does converting a chapter create a new snapshot?
      instructions:
      - text: Convert chapter {chapter_id} of project {project_id} to audio.
        slots:
          chapter_id: path.chapter_id
          project_id: path.project_id
      - text: Start conversion of only chapter {chapter_id} in {project_id}.
        slots:
          chapter_id: path.chapter_id
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/chapters/{chapter_id}/snapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List a chapter's snapshots
      effect: read
      questions:
      - Which audio snapshots exist for a specific chapter?
      - Where do I find previous conversions of one chapter?
      instructions:
      - text: List snapshots of chapter {chapter_id} in project {project_id}.
        slots:
          chapter_id: path.chapter_id
          project_id: path.project_id
      - text: Show every snapshot for chapter {chapter_id} of {project_id}.
        slots:
          chapter_id: path.chapter_id
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/chapters/{chapter_id}/snapshots/{chapter_snapshot_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one chapter snapshot
      effect: read
      questions:
      - How do I look up a specific chapter snapshot?
      - Can I get the details of one chapter snapshot by its ID?
      instructions:
      - text: Get chapter snapshot {chapter_snapshot_id} for chapter {chapter_id} in {project_id}.
        slots:
          chapter_snapshot_id: path.chapter_snapshot_id
          chapter_id: path.chapter_id
          project_id: path.project_id
      - text: Show snapshot {chapter_snapshot_id} of chapter {chapter_id}, project {project_id}.
        slots:
          chapter_snapshot_id: path.chapter_snapshot_id
          chapter_id: path.chapter_id
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/chapters/{chapter_id}/snapshots/{chapter_snapshot_id}/stream'].post
  update:
    x-apievangelist-phrasing:
      intent: Stream audio from a chapter snapshot
      effect: read
      questions:
      - Can I play back the audio for just one chapter snapshot?
      - Is chapter snapshot audio available as MPEG?
      instructions:
      - text: Stream chapter snapshot {chapter_snapshot_id} audio for chapter {chapter_id} in {project_id}.
        slots:
          chapter_snapshot_id: path.chapter_snapshot_id
          chapter_id: path.chapter_id
          project_id: path.project_id
      - text: 'Stream chapter {chapter_id} of {project_id} from snapshot {chapter_snapshot_id} as mpeg: {convert_to_mpeg}.'
        slots:
          chapter_id: path.chapter_id
          project_id: path.project_id
          chapter_snapshot_id: path.chapter_snapshot_id
          convert_to_mpeg: requestBody.convert_to_mpeg
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/muted-tracks'].get
  update:
    x-apievangelist-phrasing:
      intent: Find chapters with muted tracks
      effect: read
      questions:
      - Which chapters in my project have muted tracks?
      - How can I check a project for muted audio tracks?
      instructions:
      - text: List chapters with muted tracks in project {project_id}.
        slots:
          project_id: path.project_id
      - text: Check project {project_id} for muted tracks.
        slots:
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'