# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Action Templates API
  version: 1.0.0
extends: openapi/harness-action-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: 8
- target: $.paths['/gateway/chaos/manager/api/rest/templates/actions'].get
  update:
    x-apievangelist-phrasing:
      intent: List chaos action templates in a hub
      effect: read
      questions:
      - Which chaos action templates are available in my chaos hub?
      - Can I filter a hub's action templates by infrastructure type?
      instructions:
      - text: List action templates in chaos hub {hub} matching {search}, page {page} of {limit}.
        slots:
          hub: query.hubIdentity
          search: query.search
          page: query.page
          limit: query.limit
      - text: Show {infraType} action templates in hub {hub} for project {project}.
        slots:
          infraType: query.infraType
          hub: query.hubIdentity
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/templates/actions'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a chaos action template
      effect: write
      questions:
      - How do I add a new reusable action template to a chaos hub?
      - Can a chaos action template declare its own inputs and variables?
      instructions:
      - text: Create action template {name} in hub {hubRef}.
        slots:
          name: requestBody.name
          hubRef: requestBody.hubRef
      - text: Create a {type} action template named {name} for {infrastructureType}.
        slots:
          type: requestBody.type
          name: requestBody.name
          infrastructureType: requestBody.infrastructureType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/templates/actions/{identity}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a chaos action template
      effect: read
      questions:
      - What does a specific chaos action template do?
      - Can I fetch an older revision of an action template?
      instructions:
      - text: Get action template {identity} from hub {hub}.
        slots:
          identity: path.identity
          hub: query.hubIdentity
      - text: Show revision {revision} of action template {identity} in hub {hub}.
        slots:
          revision: query.revision
          identity: path.identity
          hub: query.hubIdentity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/templates/actions/{identity}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a chaos action template
      effect: write
      questions:
      - How do I change the configuration of an existing chaos action template?
      - Can I make an updated action template the default revision?
      instructions:
      - text: Update action template {identity} with name {name}.
        slots:
          identity: path.identity
          name: requestBody.name
      - text: Change action template {identity}'s run properties to {runProperties}, keeping name {name}.
        slots:
          identity: path.identity
          runProperties: requestBody.runProperties
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/templates/actions/{identity}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a chaos action template
      effect: destructive
      questions:
      - How do I remove an action template from a chaos hub?
      - Can I delete only one revision of an action template?
      instructions:
      - text: Delete action template {identity} from hub {hub}.
        slots:
          identity: path.identity
          hub: query.hubIdentity
      - text: Delete revision {revision} of action template {identity} in hub {hub}.
        slots:
          revision: query.revision
          identity: path.identity
          hub: query.hubIdentity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/templates/actions/{identity}/compare'].get
  update:
    x-apievangelist-phrasing:
      intent: Compare two action template revisions
      effect: read
      questions:
      - What changed between two revisions of a chaos action template?
      - Can I diff an action template's current revision against an older one?
      instructions:
      - text: Compare revision {revision} with {revisionToCompare} of action template {identity} in hub {hub}.
        slots:
          revision: query.revision
          revisionToCompare: query.revisionToCompare
          identity: path.identity
          hub: query.hubIdentity
      - text: Diff action template {identity} revisions {revision} and {revisionToCompare}.
        slots:
          identity: path.identity
          revision: query.revision
          revisionToCompare: query.revisionToCompare
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/templates/actions/{identity}/revisions'].get
  update:
    x-apievangelist-phrasing:
      intent: List revisions of an action template
      effect: read
      questions:
      - How many revisions does a chaos action template have?
      - Can I page through the revision history of an action template?
      instructions:
      - text: List revisions of action template {identity} in hub {hub}.
        slots:
          identity: path.identity
          hub: query.hubIdentity
      - text: Show page {page} of action template {identity}'s revisions, {limit} per page.
        slots:
          page: query.page
          identity: path.identity
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/templates/actions/{identity}/variables'].get
  update:
    x-apievangelist-phrasing:
      intent: List inputs of an action template revision
      effect: read
      questions:
      - What inputs does a chaos action template expect?
      - Which variables must I provide for a given action template revision?
      instructions:
      - text: List the inputs of action template {identity} at revision {revision} in hub {hub}.
        slots:
          identity: path.identity
          revision: query.revision
          hub: query.hubIdentity
      - text: Show the variables required by action template {identity} revision {revision}.
        slots:
          identity: path.identity
          revision: query.revision
      method: generated
      generated: '2026-09-26'