# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Social Posts V2 API
  version: 1.0.0
extends: openapi/vendasta-socialpostsv2-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['/v2/social-posts/list-services'].post
  update:
    x-apievangelist-phrasing:
      intent: List social accounts a business can post to
      effect: read
      questions:
      - Which connected social accounts can a business publish posts to?
      - Where do I find the social services available for posting?
      instructions:
      - text: List postable social services for business {business}.
        slots:
          business: requestBody.businessId
      - text: Show the social accounts business {business} can post to.
        slots:
          business: requestBody.businessId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/social-posts/schedule'].post
  update:
    x-apievangelist-phrasing:
      intent: Schedule social posts
      effect: write
      questions:
      - How do I schedule posts across a business's social accounts?
      - Can several social posts be scheduled in one request?
      instructions:
      - text: Schedule social posts {posts}.
        slots:
          posts: requestBody.socialPosts
      - text: 'Queue these posts for publishing: {posts}.'
        slots:
          posts: requestBody.socialPosts
      method: generated
      generated: '2026-10-01'