# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Doordash Catalog API
  version: 1.0.0
extends: openapi/doordash-catalog-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: 3
- target: $.paths['/ads/api/v1/sp/catalogs/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Check catalog products are eligible for ads
      effect: read
      questions:
      - Which of my catalog products are eligible to advertise?
      - Can I validate a batch of products before creating product ads?
      instructions:
      - text: Validate the ad eligibility of my catalog products.
      - text: Check which of these products can be advertised.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/items'].post
  update:
    x-apievangelist-phrasing:
      intent: Add new items to the item catalog
      effect: write
      questions:
      - How do I add new items to the DoorDash catalog by merchant supplied ID?
      - Do items need to be in the catalog before I set store pricing?
      instructions:
      - text: 'Add these new items to the catalog: {items}.'
        slots:
          items: requestBody.items
      - text: Create catalog items for merchant supplied IDs in {items}.
        slots:
          items: requestBody.items
      method: generated
      generated: '2026-09-26'
- target: $.paths['/items'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update existing catalog items
      effect: write
      questions:
      - How do I fix details on items already in my catalog?
      - Are catalog items matched by merchant supplied ID when updating them?
      instructions:
      - text: Update the catalog entries for existing items {items}.
        slots:
          items: requestBody.items
      - text: Correct the names and details of catalog items {items}.
        slots:
          items: requestBody.items
      method: generated
      generated: '2026-09-26'