# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Social Messages API
  version: 1.0.0
extends: openapi/vendasta-messages-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['/messages'].get
  update:
    x-apievangelist-phrasing:
      intent: List a business's social posts
      effect: read
      questions:
      - What social posts has a business published or scheduled?
      - Can I filter social messages by date range or status?
      - Is it possible to limit the list to specific social profiles?
      instructions:
      - text: List social messages for business location {location}.
        slots:
          location: query.filter[businessLocation.id]
      - text: Show posts for location {location} between {start} and {end}.
        slots:
          location: query.filter[businessLocation.id]
          start: query.filter[startAt]
          end: query.filter[endAt]
      - text: List {statuses} messages on social profiles {profiles}.
        slots:
          statuses: query.filter[statuses]
          profiles: query.filter[socialProfileIds]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/messages'].post
  update:
    x-apievangelist-phrasing:
      intent: Schedule a social message
      effect: write
      questions:
      - Can I schedule a social media message to go out later?
      - Is the message scheduling endpoint generally available or sales-gated?
      instructions:
      - text: Schedule a new social message.
      - text: Queue up a social post to publish at a later time.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/messages'].options
  update:
    x-apievangelist-phrasing:
      intent: Check allowed methods on the messages endpoint
      effect: read
      questions:
      - Which HTTP verbs does the /messages endpoint accept from a browser?
      - What does a CORS preflight to the social messages endpoint return?
      instructions:
      - text: Send an OPTIONS preflight to the messages endpoint.
      - text: List permitted verbs on the social messages collection.
      method: generated
      generated: '2026-10-01'