# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Experiment Templates API
  version: 1.0.0
extends: openapi/harness-experiment-templates-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['/gateway/chaos/manager/api/rest/experimenttemplates'].get
  update:
    x-apievangelist-phrasing:
      intent: List chaos experiment templates in a hub
      effect: read
      questions:
      - Which chaos experiment templates are available in my hub?
      - Can I filter experiment templates by tag or infrastructure type?
      - How do I search the experiment templates in a ChaosHub?
      instructions:
      - text: List experiment templates in hub {hub}.
        slots:
          hub: query.hubIdentity
      - text: Find experiment templates tagged {tags} for infrastructure type {infra_type}.
        slots:
          tags: query.tags
          infra_type: query.infrastructureType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/experimenttemplates'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a chaos experiment template
      effect: write
      questions:
      - Can I add a new experiment template to a ChaosHub from a manifest?
      - What do I need to register an experiment template?
      instructions:
      - text: Create an experiment template in hub {hub} from manifest {manifest}.
        slots:
          hub: query.hubIdentity
          manifest: requestBody.manifest
      - text: Add experiment template manifest {manifest} to my hub.
        slots:
          manifest: requestBody.manifest
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/experimenttemplates/{identity}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a chaos experiment template
      effect: read
      questions:
      - What does a specific experiment template contain?
      - Can I fetch a particular revision of an experiment template?
      instructions:
      - text: Get experiment template {template}.
        slots:
          template: path.identity
      - text: Show revision {revision} of experiment template {template}.
        slots:
          revision: query.revision
          template: path.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/experimenttemplates/{identity}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a chaos experiment template
      effect: write
      questions:
      - How do I update an experiment template with a new manifest?
      - Does editing an experiment template create a new revision?
      instructions:
      - text: Update experiment template {template} with manifest {manifest}.
        slots:
          template: path.identity
          manifest: requestBody.manifest
      - text: Replace the manifest of experiment template {template} in hub {hub}.
        slots:
          template: path.identity
          hub: query.hubIdentity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/experimenttemplates/{identity}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a chaos experiment template
      effect: destructive
      questions:
      - How do I remove an experiment template from a hub?
      - Can I delete an experiment template I no longer use?
      instructions:
      - text: Delete experiment template {template}.
        slots:
          template: path.identity
      - text: Remove experiment template {template} from hub {hub}.
        slots:
          template: path.identity
          hub: query.hubIdentity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/experimenttemplates/{identity}/compare'].get
  update:
    x-apievangelist-phrasing:
      intent: Compare two experiment template revisions
      effect: read
      questions:
      - What changed between two revisions of an experiment template?
      - Can I diff revision 1 and revision 3 of a chaos template?
      instructions:
      - text: Compare revisions {rev1} and {rev2} of experiment template {template}.
        slots:
          rev1: query.revision1
          rev2: query.revision2
          template: path.identity
      - text: Diff experiment template {template} between its revisions.
        slots:
          template: path.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/experimenttemplates/{identity}/launch'].post
  update:
    x-apievangelist-phrasing:
      intent: Launch a chaos experiment from a template
      effect: write
      questions:
      - How do I create a runnable chaos experiment from a template?
      - Can I launch an experiment from a template onto a specific infrastructure?
      instructions:
      - text: Create experiment {name} from template {template} on infrastructure {infra}.
        slots:
          name: requestBody.name
          template: path.identity
          infra: requestBody.infraRef
      - text: Launch an experiment named {name} from revision {revision} of template {template}.
        slots:
          name: requestBody.name
          revision: query.revision
          template: path.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/experimenttemplates/{identity}/revisions'].get
  update:
    x-apievangelist-phrasing:
      intent: List revisions of an experiment template
      effect: read
      questions:
      - What revisions exist for a given experiment template?
      - Can I page through the revision history of a chaos template?
      instructions:
      - text: List revisions of experiment template {template}.
        slots:
          template: path.identity
      - text: Show the latest {limit} revisions of experiment template {template}.
        slots:
          limit: query.limit
          template: path.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/experimenttemplates/{identity}/variables'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the inputs an experiment template needs
      effect: read
      questions:
      - Which input variables must I fill in before launching a template?
      - What inputs does a given revision of an experiment template expect?
      instructions:
      - text: List the input variables of experiment template {template}.
        slots:
          template: path.identity
      - text: Show the inputs for revision {revision} of template {template}.
        slots:
          revision: query.revision
          template: path.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/experimenttemplates/{identity}/yaml'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an experiment template's YAML
      effect: read
      questions:
      - Can I download the raw YAML of an experiment template?
      - What does the YAML for a particular template revision look like?
      instructions:
      - text: Get the YAML of experiment template {template}.
        slots:
          template: path.identity
      - text: Export the YAML for revision {revision} of experiment template {template}.
        slots:
          revision: query.revision
          template: path.identity
      method: generated
      generated: '2026-09-26'