# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Meltwater API v4 Export API
  version: 1.0.0
extends: openapi/meltwater-export-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['/content/export'].get
  update:
    x-apievangelist-phrasing:
      intent: List content export jobs
      effect: read
      questions:
      - Which content export jobs exist for a given data provider?
      - Can I list only my recurring content exports, not the one-time ones?
      - How do I page through a long list of content exports?
      instructions:
      - text: List content exports for the {provider} provider.
        slots:
          provider: query.provider
      - text: Show {schedule_type} content exports for {provider}.
        slots:
          schedule_type: query.schedule_type
          provider: query.provider
      - text: Get page {page} of {provider} content exports, {page_size} per page.
        slots:
          page: query.page
          provider: query.provider
          page_size: query.page_size
      method: generated
      generated: '2026-09-26'
- target: $.paths['/content/export'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a content export job
      effect: write
      questions:
      - How do I export content from my saved searches to a file?
      - Can a content export run on a cron schedule instead of just once?
      - What output settings does a new content export job need?
      instructions:
      - text: Create a {type} content export from {provider} for {query} over {period} in {tz}, delivered as {output}.
        slots:
          type: requestBody.type
          provider: requestBody.provider
          query: requestBody.query
          period: requestBody.period
          tz: requestBody.tz
          output: requestBody.output
      - text: Set up a recurring content export of {query} from {provider} on schedule {period}, timezone {tz}, output {output}, type {type}.
        slots:
          query: requestBody.query
          provider: requestBody.provider
          period: requestBody.period
          tz: requestBody.tz
          output: requestBody.output
          type: requestBody.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/content/export/{exportId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a content export job's details
      effect: read
      questions:
      - How do I check on a content export job I already started?
      - Where can I see the settings and status of one specific export job?
      instructions:
      - text: Show details for content export job {exportId}.
        slots:
          exportId: path.exportId
      - text: Check the status of export {exportId} for company {company_id}.
        slots:
          exportId: path.exportId
          company_id: query.company_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/content/export/{exportId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a content export job
      effect: destructive
      questions:
      - How do I remove a content export job I no longer need?
      - Can I delete an export job that belongs to another company on my account?
      instructions:
      - text: Delete content export job {exportId}.
        slots:
          exportId: path.exportId
      - text: Remove export {exportId} from company {company_id}.
        slots:
          exportId: path.exportId
          company_id: query.company_id
      method: generated
      generated: '2026-09-26'