# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Pipeline Refresh API
  version: 1.0.0
extends: openapi/harness-pipeline-refresh-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['/pipeline/api/refresh-template/refresh-all'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh all template inputs in a pipeline
      effect: write
      questions:
      - A template changed; how do I update every template input in a pipeline that uses it?
      - Can I refresh a Git-stored pipeline's template inputs and commit to a new branch?
      instructions:
      - text: Refresh all template inputs in pipeline {identifier}.
        slots:
          identifier: query.identifier
      - text: Recursively refresh template inputs in pipeline {identifier} on branch {branch} with commit message {commitMsg}.
        slots:
          identifier: query.identifier
          branch: query.branch
          commitMsg: query.commitMsg
      method: generated
      generated: '2026-09-26'
- target: $.paths['/pipeline/api/refresh-template/validate-template-inputs'].get
  update:
    x-apievangelist-phrasing:
      intent: Validate template inputs in a pipeline
      effect: read
      questions:
      - Are the template inputs in my pipeline YAML still valid?
      - Which template inputs in a pipeline are out of date with their templates?
      instructions:
      - text: Validate the template inputs of pipeline {identifier}.
        slots:
          identifier: query.identifier
      - text: Check pipeline {identifier} on branch {branch} for invalid template inputs.
        slots:
          identifier: query.identifier
          branch: query.branch
      method: generated
      generated: '2026-09-26'