# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Elevenlabs Audio Native API
  version: 1.0.0
extends: openapi/elevenlabs-audio-native-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: 4
- target: $.paths['/v1/audio-native'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an Audio Native embedded player
      effect: write
      questions:
      - How do I add a listen-to-this-article audio player to my blog?
      - Can an Audio Native project import content from a URL and auto-convert it?
      instructions:
      - text: Create an Audio Native project named {name}.
        slots:
          name: requestBody.name
      - text: Create Audio Native player {name} from {source_url} with voice {voice_id}.
        slots:
          name: requestBody.name
          source_url: requestBody.source_url
          voice_id: requestBody.voice_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/audio-native/{project_id}/settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Audio Native player's settings
      effect: read
      questions:
      - How do I check the player settings of an Audio Native project?
      - Can I read back how my embedded audio player is configured?
      instructions:
      - text: Get player settings for Audio Native project {project_id}.
        slots:
          project_id: path.project_id
      - text: Show the embed player configuration of {project_id}.
        slots:
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/audio-native/{project_id}/content'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload new article content to an Audio Native project
      effect: write
      questions:
      - Can I replace an Audio Native project's article by uploading an HTML or text file?
      - Will the updated article be converted and published automatically?
      instructions:
      - text: Upload {file} as the new content of Audio Native project {project_id}.
        slots:
          file: requestBody.file
          project_id: path.project_id
      - text: Replace content of {project_id} with {file}, auto-convert {auto_convert}, auto-publish {auto_publish}.
        slots:
          project_id: path.project_id
          file: requestBody.file
          auto_convert: requestBody.auto_convert
          auto_publish: requestBody.auto_publish
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/audio-native/content'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh Audio Native content from a page URL
      effect: write
      questions:
      - I updated my article; how do I get its Audio Native player to pick up the changes?
      - Can I set the author and title shown in the player when refreshing from a URL?
      instructions:
      - text: Refresh the Audio Native player for {url}.
        slots:
          url: requestBody.url
      - text: Re-extract {url} into its Audio Native project with title {title} and author {author}.
        slots:
          url: requestBody.url
          title: requestBody.title
          author: requestBody.author
      method: generated
      generated: '2026-09-26'