API Evangelist conversational phrasing for Meltwater Listening Exports API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Meltwater Listening Exports API
  version: 1.0.0
extends: openapi/meltwater-listening-exports-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: 8
- target: $.paths['/v3/exports/one-time'].get
  update:
    x-apievangelist-phrasing:
      intent: List my one-time exports
      effect: read
      questions:
      - Which one-time exports have I created?
      - Where can I see all the single-run exports on my account?
      instructions:
      - text: List all my one-time exports.
      - text: Show every single-run export I've set up.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/exports/one-time'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a one-time export
      effect: write
      questions:
      - How do I export listening results once, without a schedule?
      - Can I create a one-off export for a different company on my account?
      instructions:
      - text: Create a one-time export with settings {onetime_export}.
        slots:
          onetime_export: requestBody.onetime_export
      - text: Start a single-run export {onetime_export} for company {company_id}.
        slots:
          onetime_export: requestBody.onetime_export
          company_id: query.company_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/exports/one-time/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a one-time export's details
      effect: read
      questions:
      - Is my one-time export finished yet?
      - What settings did I use for a particular one-off export?
      instructions:
      - text: Show details of one-time export {id}.
        slots:
          id: path.id
      - text: Check whether single-run export {id} is ready to download.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/exports/one-time/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a one-time export
      effect: destructive
      questions:
      - How do I get rid of an old one-time export?
      - Can I remove a one-off export once I've downloaded it?
      instructions:
      - text: Delete one-time export {id}.
        slots:
          id: path.id
      - text: Remove single-run export {id} from my account.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/exports/recurring'].get
  update:
    x-apievangelist-phrasing:
      intent: List my recurring exports
      effect: read
      questions:
      - Which recurring exports are currently scheduled?
      - What scheduled exports run automatically on my account?
      instructions:
      - text: List all my recurring exports.
      - text: Show every scheduled export I have running.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/exports/recurring'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a recurring export
      effect: write
      questions:
      - How do I set up an export of listening data that repeats on a schedule?
      - Can I schedule a recurring export for another company I manage?
      instructions:
      - text: Create a recurring export with settings {recurring_export}.
        slots:
          recurring_export: requestBody.recurring_export
      - text: Schedule repeating export {recurring_export} for company {company_id}.
        slots:
          recurring_export: requestBody.recurring_export
          company_id: query.company_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/exports/recurring/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a recurring export's details
      effect: read
      questions:
      - What schedule is a particular recurring export on?
      - How can I view the configuration of one scheduled export?
      instructions:
      - text: Show details of recurring export {id}.
        slots:
          id: path.id
      - text: Look up the schedule and settings of scheduled export {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/exports/recurring/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a recurring export
      effect: destructive
      questions:
      - How do I stop a recurring export from running again?
      - Can I cancel a scheduled export permanently?
      instructions:
      - text: Delete recurring export {id}.
        slots:
          id: path.id
      - text: Remove scheduled export {id} so it stops running.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'