API Evangelist conversational phrasing for ElevenLabs API Documentation Productions 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 Productions API
  version: 1.0.0
extends: openapi/elevenlabs-productions-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: 11
- target: $.paths['/v1/productions/orders'].get
  update:
    x-apievangelist-phrasing:
      intent: List Productions orders
      effect: read
      questions:
      - What Productions orders has my workspace placed?
      - Can I filter Productions orders by status or a date range?
      instructions:
      - text: List my Productions orders.
      - text: Show Productions orders with status {status}.
        slots:
          status: query.status
      - text: List Productions orders created between {start_date} and {end_date}.
        slots:
          start_date: query.start_date
          end_date: query.end_date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/productions/orders'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a new Productions order
      effect: write
      questions:
      - How do I start an order for human-reviewed Productions work?
      - Does a new Productions order start open so I can add items before submitting?
      instructions:
      - text: Create a new Productions order.
      - text: Open a fresh Productions order in my workspace.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/productions/orders/{order_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Productions order and its quote
      effect: read
      questions:
      - What's the quoted price on my Productions order?
      - Can I check the status of a Productions order I submitted?
      instructions:
      - text: Get Productions order {order_id}.
        slots:
          order_id: path.order_id
      - text: Show the quote and status for order {order_id}.
        slots:
          order_id: path.order_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/productions/orders/{order_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an open Productions order
      effect: write
      questions:
      - Can I change a Productions order before I submit it?
      - Is it possible to edit an order after submission?
      instructions:
      - text: Update open order {order_id} with {request}.
        slots:
          order_id: path.order_id
          request: requestBody.request
      - text: Apply changes {request} to Productions order {order_id}.
        slots:
          request: requestBody.request
          order_id: path.order_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/productions/orders/{order_id}/media'].post
  update:
    x-apievangelist-phrasing:
      intent: Attach a media file to a Productions order
      effect: write
      questions:
      - How do I attach my video to a Productions order?
      - Can I give a URL for the media instead of uploading the file?
      instructions:
      - text: Upload {media} in {declared_language} to order {order_id}.
        slots:
          media: requestBody.media
          declared_language: requestBody.declared_language
          order_id: path.order_id
      - text: Register media from {media_url} in language {declared_language} on order {order_id}.
        slots:
          media_url: requestBody.media_url
          declared_language: requestBody.declared_language
          order_id: path.order_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/productions/orders/{order_id}/media/{media_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an order's uploaded media and download link
      effect: read
      questions:
      - Can I re-download a media file I attached to an order?
      - What metadata is stored for media registered on a Productions order?
      instructions:
      - text: Get media {media_id} on order {order_id}.
        slots:
          media_id: path.media_id
          order_id: path.order_id
      - text: Give me a download link for media {media_id} of order {order_id}.
        slots:
          media_id: path.media_id
          order_id: path.order_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/productions/orders/{order_id}/items'].post
  update:
    x-apievangelist-phrasing:
      intent: Add or change an item on an order
      effect: write
      questions:
      - How do I add a line item to my Productions order and see its price?
      - Can I update an item already on an open order?
      instructions:
      - text: Add item {request} to order {order_id}.
        slots:
          request: requestBody.request
          order_id: path.order_id
      - text: Upsert order item {request} on {order_id} and tell me the quoted price.
        slots:
          request: requestBody.request
          order_id: path.order_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/productions/orders/{order_id}/items/{item_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an item from an open order
      effect: destructive
      questions:
      - Can I take an item off a Productions order before submitting?
      - How do I drop a line item I added by mistake?
      instructions:
      - text: Remove item {item_id} from order {order_id}.
        slots:
          item_id: path.item_id
          order_id: path.order_id
      - text: Delete line item {item_id} on open order {order_id}.
        slots:
          item_id: path.item_id
          order_id: path.order_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/productions/orders/{order_id}/submit'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit a Productions order for processing
      effect: write
      questions:
      - What happens when I submit a Productions order?
      - Can I still modify items after an order is submitted?
      instructions:
      - text: Submit Productions order {order_id}.
        slots:
          order_id: path.order_id
      - text: Send order {order_id} off for processing.
        slots:
          order_id: path.order_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/productions/orders/{order_id}/deliverables'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a completed order's deliverables
      effect: read
      questions:
      - Where are the finished files for my Productions order?
      - Why is my order's deliverables list empty?
      instructions:
      - text: Get the deliverables for order {order_id}.
        slots:
          order_id: path.order_id
      - text: List the delivered files of completed order {order_id}.
        slots:
          order_id: path.order_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/productions/orders/languages/{order_item_kind}'].get
  update:
    x-apievangelist-phrasing:
      intent: List languages offered for an order item type
      effect: read
      questions:
      - Which languages can Productions deliver for a given kind of item?
      - Is my language supported before I add an item to an order?
      instructions:
      - text: List available languages for order item kind {order_item_kind}.
        slots:
          order_item_kind: path.order_item_kind
      - text: Check which languages {order_item_kind} items support.
        slots:
          order_item_kind: path.order_item_kind
      method: generated
      generated: '2026-09-26'