# 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 Comments API
  version: 1.0.0
extends: openapi/facebook-business-manager-comments-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['/{post_id}/comments'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the comments on a Page post
      effect: read
      questions:
      - What are people saying in the comments on my Page post?
      - Can I sort a post's comments newest first?
      - Is it possible to filter comments by type, such as top-level only?
      instructions:
      - text: Show the comments on post {post_id}.
        slots:
          post_id: path.post_id
      - text: List comments on post {post_id} in {order} order.
        slots:
          post_id: path.post_id
          order: query.order
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{post_id}/comments'].post
  update:
    x-apievangelist-phrasing:
      intent: Reply to a Page post as the Page
      effect: write
      questions:
      - Can my Page reply in the comments of its own post?
      - Which permission does the Page token need to comment on a post?
      - Can a comment include an image?
      instructions:
      - text: Comment {message} on post {post_id} as the Page.
        slots:
          post_id: path.post_id
          message: requestBody.message
      - text: Post a comment on {post_id} saying {message} with the image at {attachment_url}.
        slots:
          post_id: path.post_id
          message: requestBody.message
          attachment_url: requestBody.attachment_url
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{comment_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a comment from a Page post
      effect: destructive
      questions:
      - Can I remove a spam comment left on my Page's post?
      - Whose comments is my Page allowed to delete?
      instructions:
      - text: Delete comment {comment_id}.
        slots:
          comment_id: path.comment_id
      - text: Remove the comment {comment_id} from my Page post.
        slots:
          comment_id: path.comment_id
      method: generated
      generated: '2026-10-01'