# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Console Change Validation API
  version: 1.0.0
extends: openapi/statsig-change-validation-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: 2
- target: $.paths['/console/v1/change_validation'].post
  update:
    x-apievangelist-phrasing:
      intent: Report a change validation result
      effect: write
      questions:
      - How can our CI pipeline mark a config review as validated?
      - Can I attach debug links to a change validation result?
      instructions:
      - text: Mark review {reviewID} as validated {validated}.
        slots:
          reviewID: requestBody.reviewID
          validated: requestBody.validated
      - text: Report validation {validated} for review {reviewID} with message {message} and debug links {debugLinks}.
        slots:
          reviewID: requestBody.reviewID
          validated: requestBody.validated
          message: requestBody.message
          debugLinks: requestBody.debugLinks
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/change_validation/message'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a change validation message
      effect: write
      questions:
      - Can I edit the message shown on a validation after it was posted?
      - Is it possible to update validation status text while checks are still running?
      instructions:
      - text: Change the validation message on review {reviewID} to {message}.
        slots:
          reviewID: requestBody.reviewID
          message: requestBody.message
      - text: Post progress note {message} on review {reviewID}.
        slots:
          reviewID: requestBody.reviewID
          message: requestBody.message
      method: generated
      generated: '2026-10-01'