# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns Vendors API
  version: 1.0.0
extends: openapi/mediamath-vendors-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/vendors'].get
  update:
    x-apievangelist-phrasing:
      intent: List vendors
      effect: read
      questions:
      - Which ad tech vendors are registered on the platform?
      - Can I search vendors and include their detected domains?
      instructions:
      - text: List all vendors.
      - text: Find vendors matching {q}.
        slots:
          q: query.q
      - text: List vendors with full details sorted by {sort_by}.
        slots:
          sort_by: query.sort_by
      method: generated
      generated: '2026-10-01'
- target: $.paths['/vendors/{vendor_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a vendor
      effect: read
      questions:
      - How do I look up one vendor by its ID?
      - What details are stored for a given vendor?
      instructions:
      - text: Get vendor {vendor_id}.
        slots:
          vendor_id: path.vendor_id
      - text: Show the details of vendor {vendor_id}.
        slots:
          vendor_id: path.vendor_id
      method: generated
      generated: '2026-10-01'