# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for AppConnect V3 Social API
  version: 1.0.0
extends: openapi/constant-contact-social-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: 4
- target: $.paths['/social/profiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List connected social media profiles
      effect: read
      questions:
      - Which Facebook, LinkedIn or Instagram pages can I post to?
      - Can I see every social profile connected to my account?
      instructions:
      - text: List my connected social profiles.
      - text: List my social profiles including {include}.
        slots:
          include: query.include
      method: generated
      generated: '2026-10-01'
- target: $.paths['/social/connections'].get
  update:
    x-apievangelist-phrasing:
      intent: List social network connections
      effect: read
      questions:
      - Which social network accounts are authorized with my account?
      - Is my connection to a social network still valid?
      instructions:
      - text: List my social network connections.
      - text: Show which social accounts are linked and authorized.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/social/hashtags/groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List saved hashtag groups
      effect: read
      questions:
      - What hashtag groups have I saved for social posts?
      - Can I page through my hashtag groups?
      instructions:
      - text: List my saved hashtag groups.
      - text: Show page {page} of my hashtag groups.
        slots:
          page: query.page
      method: generated
      generated: '2026-10-01'
- target: $.paths['/social/posts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or schedule a social media post
      effect: write
      questions:
      - Can I schedule a social post to several profiles at once?
      - Is it possible to save a social post as a draft instead of publishing?
      instructions:
      - text: Create a social post {profile_posts} with status {status}.
        slots:
          profile_posts: requestBody.profile_posts
          status: requestBody.status
      - text: Schedule social post {profile_posts} for {scheduled_time} with status {status}.
        slots:
          profile_posts: requestBody.profile_posts
          scheduled_time: requestBody.scheduled_time
          status: requestBody.status
      method: generated
      generated: '2026-10-01'