# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Dify Service Feedback API
  version: 1.0.0
extends: openapi/dify-feedback-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/messages/{message_id}/feedbacks'].post
  update:
    x-apievangelist-phrasing:
      intent: Like, dislike or revoke feedback on a message
      effect: write
      questions:
      - How do I record a thumbs up or thumbs down on an assistant reply?
      - Can I take back feedback I already left on a message?
      - Is it possible to add a written comment along with a rating?
      instructions:
      - text: Rate message {message_id} as {rating} on behalf of user {user}.
        slots:
          message_id: path.message_id
          rating: requestBody.rating
          user: requestBody.user
      - text: Leave the comment {content} on message {message_id} from user {user}.
        slots:
          content: requestBody.content
          message_id: path.message_id
          user: requestBody.user
      method: generated
      generated: '2026-09-26'
- target: $.paths['/app/feedbacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List all feedback on an app's messages
      effect: read
      questions:
      - What feedback have users and admins left across my Dify app?
      - Can I page through every like and dislike the app has received?
      instructions:
      - text: List all feedback submitted on this app's messages.
      - text: Show page {page} of app feedback with {limit} items per page.
        slots:
          page: query.page
          limit: query.limit
      method: generated
      generated: '2026-09-26'