# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Matomo Reporting API for plugin Feedback API
  version: 1.0.0
extends: openapi/matomo-feedback-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['/index.php?module=API&method=Feedback.sendFeedbackForFeature'].get
  update:
    x-apievangelist-phrasing:
      intent: Send feedback about a feature
      effect: write
      questions:
      - How can I tell the Matomo team whether I like a particular feature?
      - Can I attach a written comment when rating a feature?
      instructions:
      - text: 'Send feedback on the feature {featureName} saying I like it: {like}.'
        slots:
          featureName: query.featureName
          like: query.like
      - text: Submit feedback for feature {featureName} with the message {message}.
        slots:
          featureName: query.featureName
          message: query.message
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=Feedback.sendFeedbackForSurvey'].get
  update:
    x-apievangelist-phrasing:
      intent: Answer a feedback survey question
      effect: write
      questions:
      - How do I respond to an in-app survey question?
      - Where does my survey answer get sent?
      instructions:
      - text: Answer the survey question {question} with {message}.
        slots:
          question: query.question
          message: query.message
      - text: Submit a survey response to {question}.
        slots:
          question: query.question
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=Feedback.updateFeedbackReminderDate'].get
  update:
    x-apievangelist-phrasing:
      intent: Postpone the feedback reminder
      effect: write
      questions:
      - Can I stop the feedback prompt from appearing for a while?
      - How long is the feedback reminder snoozed when I postpone it?
      instructions:
      - text: Postpone my feedback reminder by six months.
      - text: Snooze the feedback request prompt for me.
      method: generated
      generated: '2026-10-01'