API Evangelist conversational phrasing for Harness Project Template API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Project Template API
  version: 1.0.0
extends: openapi/harness-project-template-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: 10
- target: $.paths['/v1/orgs/{org}/projects/{project}/templates/git-metadata/{template}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update Git details of a project template
      effect: write
      questions:
      - Can I update the Git details stored for every version of a project template?
      - What changes the Git metadata of a template in my project?
      instructions:
      - text: Update Git details for template {template} in project {project} of org {org}.
        slots:
          template: path.template
          org: path.org
          project: path.project
      - text: Refresh Git metadata on project template {template}.
        slots:
          template: path.template
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List templates in a project
      effect: read
      questions:
      - Which templates exist in my project?
      - Can I filter project templates by type or search term?
      instructions:
      - text: List templates in project {project} of org {org}.
        slots:
          org: path.org
          project: path.project
      - text: Search templates in project {project} for {term}.
        slots:
          project: path.project
          term: query.search_term
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a project template
      effect: write
      questions:
      - Can I create a new pipeline template scoped to one project?
      - What YAML do I need to add a template at project level?
      instructions:
      - text: Create template {name} in project {project} of org {org} from YAML {yaml}.
        slots:
          name: requestBody.name
          yaml: requestBody.template_yaml
          org: path.org
          project: path.project
      - text: Add a stable template with YAML {yaml} to project {project}.
        slots:
          yaml: requestBody.template_yaml
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/templates/{template}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the stable version of a project template
      effect: read
      questions:
      - Which version of a project template is currently marked stable?
      - Can I read the stable template's YAML from a specific Git branch?
      instructions:
      - text: Get the stable version of template {template} in project {project}, org {org}.
        slots:
          template: path.template
          org: path.org
          project: path.project
      - text: Show stable template {template} YAML from branch {branch}.
        slots:
          template: path.template
          branch: query.branch_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/templates/{template}/versions/{version}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a specific project template version
      effect: read
      questions:
      - Can I fetch one particular version of a project template?
      - Is the YAML included when I retrieve a template by version label?
      instructions:
      - text: Get version {version} of template {template} in project {project}.
        slots:
          version: path.version
          template: path.template
          project: path.project
      - text: Retrieve template {template} version {version} with YAML in org {org}.
        slots:
          template: path.template
          version: path.version
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/templates/{template}/versions/{version}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a project template version
      effect: write
      questions:
      - Can I edit the YAML of an existing template version in a project?
      - Is a commit comment recorded when I update a template version?
      instructions:
      - text: Update template {template} version {version} with YAML {yaml}.
        slots:
          template: path.template
          version: path.version
          yaml: requestBody.template_yaml
      - text: Edit version {version} of template {template} in project {project}, org {org}.
        slots:
          version: path.version
          template: path.template
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/templates/{template}/versions/{version}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a project template version
      effect: destructive
      questions:
      - Can I delete one version of a template in my project?
      - Is it possible to force-delete a template version that is still referenced?
      instructions:
      - text: Delete version {version} of template {template} in project {project}, org {org}.
        slots:
          version: path.version
          template: path.template
          org: path.org
          project: path.project
      - text: Force delete template {template} version {version} set to {force}.
        slots:
          template: path.template
          version: path.version
          force: query.forceDelete
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/templates/{template}/versions/{version}/stable'].put
  update:
    x-apievangelist-phrasing:
      intent: Mark a project template version stable
      effect: write
      questions:
      - How do I promote a template version to stable in my project?
      - Can I change which version of a project template is the stable one?
      instructions:
      - text: Make version {version} the stable version of template {template} in project {project}, org {org}.
        slots:
          version: path.version
          template: path.template
          org: path.org
          project: path.project
      - text: Set template {template} stable version to {version}.
        slots:
          template: path.template
          version: path.version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/templates/{template}/import'].post
  update:
    x-apievangelist-phrasing:
      intent: Import a template from Git into a project
      effect: write
      questions:
      - Can I import a template that already lives in a Git repo into my project?
      - What details are needed to import a project template from Git?
      instructions:
      - text: Import template {template} into project {project} of org {org}.
        slots:
          template: path.template
          org: path.org
          project: path.project
      - text: Import template {template} from Git using {details}.
        slots:
          template: path.template
          details: requestBody.git_import_details
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/templates/{template}/versions/{version}/inputs-schema'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a project template's inputs schema
      effect: read
      questions:
      - What runtime inputs does a project template version expect?
      - Can I get the input schema for a template before using it?
      instructions:
      - text: Get the inputs schema for template {template} version {version} in project {project}, org {org}.
        slots:
          template: path.template
          version: path.version
          org: path.org
          project: path.project
      - text: Show required inputs for template {template} version {version}.
        slots:
          template: path.template
          version: path.version
      method: generated
      generated: '2026-09-26'