# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Facebook Business Manager Facebook Pages Posts API
  version: 1.0.0
extends: openapi/facebook-business-manager-posts-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: 5
- target: $.paths['/{page_id}/feed'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the posts on a Page's feed
      effect: read
      questions:
      - What has been posted on my Page recently?
      - Does a Page's feed include visitor posts as well as the Page's own?
      instructions:
      - text: Show the feed for Page {page_id}.
        slots:
          page_id: path.page_id
      - text: List the latest {limit} posts on Page {page_id}.
        slots:
          page_id: path.page_id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{page_id}/feed'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish or schedule a post on a Page
      effect: write
      questions:
      - Can I schedule a Page post for next week instead of publishing now?
      - How far ahead can a Page post be scheduled?
      - Is it possible to share a link in a new Page post?
      instructions:
      - text: Post {message} on Page {page_id}.
        slots:
          page_id: path.page_id
          message: requestBody.message
      - text: Share link {link} on Page {page_id} with the text {message}.
        slots:
          page_id: path.page_id
          link: requestBody.link
          message: requestBody.message
      - text: Schedule a post {message} on Page {page_id} for {scheduled_publish_time}.
        slots:
          page_id: path.page_id
          message: requestBody.message
          scheduled_publish_time: requestBody.scheduled_publish_time
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{post_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one post's content and engagement
      effect: read
      questions:
      - How many reactions did a specific post get?
      - Can I see the attachments on one particular post?
      instructions:
      - text: Show me post {post_id}.
        slots:
          post_id: path.post_id
      - text: Get the {fields} of post {post_id}.
        slots:
          post_id: path.post_id
          fields: query.fields
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{post_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Edit the text of a published post
      effect: write
      questions:
      - Can I fix a typo in a post that's already published?
      - What can I change on a post after it goes live?
      instructions:
      - text: Change the text of post {post_id} to {message}.
        slots:
          post_id: path.post_id
          message: requestBody.message
      - text: Edit the message on my published post {post_id} to read {message}.
        slots:
          post_id: path.post_id
          message: requestBody.message
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{post_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a post from a Page
      effect: destructive
      questions:
      - Can I take down a post from my Page for good?
      - Is deleting a Page post reversible?
      instructions:
      - text: Delete post {post_id}.
        slots:
          post_id: path.post_id
      - text: Permanently remove post {post_id} from the Page.
        slots:
          post_id: path.post_id
      method: generated
      generated: '2026-10-01'