# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Product Catalog - Public Variant Data Bulk Operations API
  version: 1.0.0
extends: openapi/mapp-variant-data-bulk-operations-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['/api/product-catalog/v1/catalogs/{catalogId}/variants/bulk'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace many variants at once
      effect: write
      questions:
      - Can I fully overwrite up to 1000 variants in one request?
      - How do I bulk replace variant data in a catalog?
      instructions:
      - text: Bulk replace these variants in catalog {catalogId}.
        slots:
          catalogId: path.catalogId
      - text: Upsert a batch of up to 1000 variants into catalog {catalogId}, overwriting existing data.
        slots:
          catalogId: path.catalogId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/product-catalog/v1/catalogs/{catalogId}/variants/bulk'].post
  update:
    x-apievangelist-phrasing:
      intent: Add many variants without overwriting
      effect: write
      questions:
      - Can I bulk load variants while keeping values that already exist?
      - What's the per-request limit when adding variants in bulk?
      instructions:
      - text: Bulk add these variants to catalog {catalogId}, filling only missing fields.
        slots:
          catalogId: path.catalogId
      - text: Load a batch of new variants into catalog {catalogId}.
        slots:
          catalogId: path.catalogId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/product-catalog/v1/catalogs/{catalogId}/variants/bulk'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete many variants at once
      effect: destructive
      questions:
      - How do I delete a batch of variants from a catalog in one call?
      - Are missing variants skipped when bulk deleting?
      instructions:
      - text: Bulk delete these variants from catalog {catalogId}.
        slots:
          catalogId: path.catalogId
      - text: Remove this list of variant IDs from catalog {catalogId}.
        slots:
          catalogId: path.catalogId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/product-catalog/v1/catalogs/{catalogId}/variants/bulk'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change selected fields on many variants
      effect: write
      questions:
      - Can I update just the prices on hundreds of variants at once?
      - Do bulk partial updates skip variants that don't exist?
      instructions:
      - text: Bulk patch prices for these variants in catalog {catalogId}.
        slots:
          catalogId: path.catalogId
      - text: Update availability on a batch of existing variants in catalog {catalogId}.
        slots:
          catalogId: path.catalogId
      method: generated
      generated: '2026-09-26'