# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for ElevenLabs Studio Projects API
  version: 1.0.0
extends: openapi/elevenlabs-projects-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: 6
- target: $.paths['/v1/studio/projects'].get
  update:
    x-apievangelist-phrasing:
      intent: List all Studio projects
      effect: read
      questions:
      - Which long-form audio projects do I have in Studio?
      - Can I see the status of all my Studio projects?
      instructions:
      - text: List all my Studio projects with their status.
      - text: Show every long-form project in my account.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a long-form Studio project
      effect: write
      questions:
      - How do I create a Studio project for an audiobook with a default voice?
      - Can I import a document or URL when creating a project?
      instructions:
      - text: Create project {name} with default voice {default_voice_id}.
        slots:
          name: requestBody.name
          default_voice_id: requestBody.default_voice_id
      - text: Start project {name} from {from_url} voiced by {default_voice_id}.
        slots:
          name: requestBody.name
          from_url: requestBody.from_url
          default_voice_id: requestBody.default_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 with chapters and status
      effect: read
      questions:
      - How can I see a project's chapters and voice assignments?
      - Is my Studio project finished rendering?
      instructions:
      - text: Get project {project_id} with its chapters.
        slots:
          project_id: path.project_id
      - text: Check rendering status of project {project_id}.
        slots:
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Studio project and its content
      effect: destructive
      questions:
      - Does deleting a project also remove all its chapters and audio?
      - How do I get rid of a Studio project?
      instructions:
      - text: Delete project {project_id} and all its content.
        slots:
          project_id: path.project_id
      - text: Permanently remove Studio project {project_id}.
        slots:
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/studio/projects/{project_id}/convert'].post
  update:
    x-apievangelist-phrasing:
      intent: Render a Studio project's final audio
      effect: write
      questions:
      - How do I produce the final audio for my whole project?
      - Can I render all chapters and voice assignments in one go?
      instructions:
      - text: Render project {project_id}.
        slots:
          project_id: path.project_id
      - text: Generate final audio for all chapters of 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 project's rendered snapshots
      effect: read
      questions:
      - Where can I find completed renders of my project?
      - What does each project snapshot represent?
      instructions:
      - text: List rendered snapshots of project {project_id}.
        slots:
          project_id: path.project_id
      - text: Show completed renders for {project_id}.
        slots:
          project_id: path.project_id
      method: generated
      generated: '2026-09-26'