# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Reputation REST Business Location Reviews API
  version: 1.0.0
extends: openapi/vendasta-business-location-reviews-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['/businessLocationReviews'].get
  update:
    x-apievangelist-phrasing:
      intent: List reviews for a business location
      effect: read
      questions:
      - What reviews has one of my business locations received?
      - Can I filter reviews by star rating, date range or a phrase?
      - Can I see reviews from just one listing source?
      instructions:
      - text: List reviews for business location {location}.
        slots:
          location: query.filter[businessLocation.id]
      - text: Show {rating}-star reviews for {location} since {start}.
        slots:
          rating: query.filter[rating]
          location: query.filter[businessLocation.id]
          start: query.filter[startAt]
      - text: Find reviews at {location} that mention {phrase}.
        slots:
          location: query.filter[businessLocation.id]
          phrase: query.filter[phrase]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/businessLocationReviews'].options
  update:
    x-apievangelist-phrasing:
      intent: Check allowed methods on location reviews
      effect: read
      questions:
      - Which HTTP verbs does the business location reviews endpoint accept for CORS?
      - What does a preflight on the reviews list return?
      instructions:
      - text: Send a CORS preflight to the business location reviews list.
      - text: Show allowed methods for the location review collection endpoint.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/businessLocationReviews/{id}/actions/suggestResponse'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an AI-suggested reply to a review
      effect: read
      questions:
      - Can AI draft a response to a customer review for me?
      - How do I get a suggested reply for a specific review?
      instructions:
      - text: Suggest a response to review {id}.
        slots:
          id: path.id
      - text: Draft an AI reply for review {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'