# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Methodfi Merchants API
  version: 1.0.0
extends: openapi/methodfi-merchants-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: 3
- target: $.paths['/merchants'].get
  update:
    x-apievangelist-phrasing:
      intent: Search the merchant directory
      effect: read
      questions:
      - Can I find a lender in Method's merchant directory by name?
      - How do I list merchants of a particular type?
      instructions:
      - text: Find merchants named {name}.
        slots:
          name: query.name
      - text: List merchants of type {type}.
        slots:
          type: query.type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/merchants/{mchId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a merchant (versioned)
      effect: read
      questions:
      - Which versioned call returns one merchant by mchId?
      - Can I fetch a merchant's details on the current API version?
      instructions:
      - text: Get merchant {merchant} on API version {version}.
        slots:
          merchant: path.mchId
          version: header.Method-Version
      - text: Show directory details for merchant {merchant}.
        slots:
          merchant: path.mchId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/merchants/{mch_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a merchant (legacy unversioned path)
      effect: read
      questions:
      - Is there an older merchant lookup that takes mch_id without a version header?
      - Can I still read a merchant via the legacy mch_id endpoint?
      instructions:
      - text: Look up merchant {mch_id} on the legacy unversioned endpoint.
        slots:
          mch_id: path.mch_id
      - text: Fetch merchant {mch_id} without sending a Method-Version header.
        slots:
          mch_id: path.mch_id
      method: generated
      generated: '2026-10-01'