# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Mailchimp Marketing Batches API
  version: 1.0.0
extends: openapi/mailchimp-batches-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['/batches'].get
  update:
    x-apievangelist-phrasing:
      intent: List batch operation requests
      effect: read
      questions:
      - Which batch operation requests have I submitted recently?
      - Can I see a summary of all my past batch jobs?
      instructions:
      - text: List my batch requests.
      - text: Show {count} recent batch operation summaries.
        slots:
          count: query.count
      method: generated
      generated: '2026-09-26'
- target: $.paths['/batches'].post
  update:
    x-apievangelist-phrasing:
      intent: Run many API calls as one batch
      effect: write
      questions:
      - How do I send hundreds of API calls in a single batch request?
      - Can I bundle many subscriber updates into one asynchronous job?
      instructions:
      - text: 'Start a batch with these operations: {operations}.'
        slots:
          operations: requestBody.operations
      - text: Submit {operations} as a single batch job.
        slots:
          operations: requestBody.operations
      method: generated
      generated: '2026-09-26'
- target: $.paths['/batches/{batch_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a batch request's progress
      effect: read
      questions:
      - Has my batch request finished, and how many operations failed?
      - Where do I get the results file for a completed batch?
      instructions:
      - text: Check the status of batch {batch_id}.
        slots:
          batch_id: path.batch_id
      - text: Get the response body URL for finished batch {batch_id}.
        slots:
          batch_id: path.batch_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/batches/{batch_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Stop a running batch request
      effect: destructive
      questions:
      - Can I cancel a long-running batch that's blocking my other batches?
      - What happens to results when I stop a batch request?
      instructions:
      - text: Stop batch request {batch_id}.
        slots:
          batch_id: path.batch_id
      - text: Cancel the long-running batch {batch_id}.
        slots:
          batch_id: path.batch_id
      method: generated
      generated: '2026-09-26'